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The tops of the keys show a full ASCII character set. The yellow characters on the key fronts are the APL special 
characters. The DECsystem-10 uses only the ASCII character set, so the yellow key fronts should be Ignored. Of 
special interest to the DECsystem-10 user are the ESC key (ESCape, also called altmode), the BACKSPACE key 
(equivalent to RUBOUT for everything but DDT, where DELETE should be used), the TAB key, the LINE FEED key, and the 
CTRL (ConTRoL) key. CAPS LOCK is not the same as shift. It only affects the sending of alphabetic characters. Do 
not use the BREAK and REPEAT keys. 

To Sign on and to Sign off the DECsystem-10 

1. Check all eight buttons at the left of the keyboard. Only the one marked 300 should be down . The other seven 
should be u£. (To change the state of a button, press it once.) 

2. Press ON (upper left of keyboard). The red light marked STD CHAR SET will light. (This is the ASCII 

character set.) 

3. Press RETURN button. The computer will print a one-line response followed by a slash (prompt) at the left 
marg in . 

A. After the slash prints, type LOGIN followed by a space and your account number. For example! 

■LOGIN 7000,12 

Press RETURN after typing your account number. The DECsystem-10 monitor will respond by printing any special 
system messages. Then, on a new line, the system will print the word PASSWORD: . 

5. You may now enter your password. Note that your password does not print at the terminal. Printing at the 

terminal is turned off in order to help you to keep your password secret. If the LOGIN is successful, a 
message of the day will print, followed by a period (prompt) at the left margin. You may now run any user 
programs on the DECsystem-10. 

6. To sign off from the DECsystem-10, enter the command KJOB. The monitor will respond by printing the word 

CONFIRM: . If you wish to save all files, you should respond by typing the letter F. When H (for Help) is 
entered instead of F, the system will print out descriptions of other acceptable responses to the word - C0NFIRM . 
After the charge information and exit messages have printed, you may press the OFF switch and leave the 

terminal; or you may sign on again to any timesharing system such as APL on the 370/155, or the DECsystem-10. 


Sample Sign-on/Slgn-off 

For the purpose of illustration, assume your LOGIN number is 7000,12 and your password is Y0. The printed lines 
shown below are similar to the lines of print that you would see at the terminal if you signed on with this account 
number and password. Note that the password is not printed. 

0/2) SU II ME SHARING 10.33.06 FRI 08/04/78 V1M28 
/LOGIN ,’000.12 
LOGIN 7000.12 

JOB 15 SYRACUSE UNIVERSITY 6.03 TTY6 
Password! 

1037 04-Aua-78 Fri 

Sample Si g n-off 

. KJOB 

Confirm: F 

Job 15. User 17000.121 Loaned off TTY6 1036 4-AuN-78 

Saved all files <65 blocks) 

Runtime 0.66 Sec 

CHARGE i »0.10- *0. 03 < C) +»0. 05< P) F*0 . 02<R) 

Y-T-D ACCOUNT USE ! 1 3X 


Warning 

DO NOT PULL THE PAPER FROM THE TOP. Turn the carriage up by hand, 
feed, call the Computing Center for help - ext. 3-32A5. 


If the terminal does not have paper in the 
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This memo is intended to explain several words and concepts 
relating to the DECsystem™10 computer that often confuse or mystify 
the novice computer user* The words that are explained are underlined 
in the text of this memo* The words are also listed alphabetically at 
t h e e n d o f t h e m e m o w :i. t h t h e 1 i n e n u m b e r w h e r e e a c h i s e x p 1 a i n e d ♦ 

PARTS OF THE COMPUTER THAT UE NEED 
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T h e S y r a e u s e U n i 

0 f c o u r s e ? s o don'' t 
or to the 10* The DE 

1 m p o r t a n t p a r t i s 
This is the unit whic 
o f i n s t r u c t i o n s * T h a 
m a n i p u 1 a t i o n s ? 
o n w h i 1 e i t d o e s 
or memory* 


etc* 


its 
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versity DECsystem-10 computer has nicknames 
be confused if someone refers to the DEC™ 10 
C™;l.0 is made up of several parts* The most 
called the Ce n t r a 1 P r o ce s s 1 n d U n 1 1 or CPU * 
h controls the interpretation and execution 
t is? the CPU does the actual calculations? 
ihe CPU needs a “scratch pad" to make notes 
w o r k ♦ T h i s s t o r a d e i s c a 1 1 e d c o r e s t o r a d e 


10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 
O'K 

A<« W 

24 

An *..* 
26 

,yy 
A .. / 

28 


f ne other parts of the computer are called peripheral 
devices * These devices are used for input and output < 1/0 ) and 
f o r s t o r a d e o l - i n f o r m a t i o n * I ! "i e i n p i..i t d e v i c e s a r e t h e c a r d 
reader? a device that reads the information stored on punched 

cards? and a terminal ? a personal typewriter like device that 

car i ^ foe used for both input and output* Output can also be sent 
to the 1 ine printer ? a hidh speed print i rid device which all 
users can send information to for printing* 

bine© core s ‘cored© is limited? we need a place to store 
lard© amounts ot information for future use* The stored© 
d e v i e e s a re a 1 1 m a d e o f m a d n e t i c m a t e r i a 1 s t h a t c a n fo e 
m a d r i e b i z e d i n s u c h a w a y t h a t t h e y r e p r e s e n t i r - i f o r m a t i o n » A 
® 1 ® fo f r i t s d i s e s h a p e ? :i. t i s a 1 w a y s c o n n e e t e d t o t h e 

computer* Madtape is madnetic record! nd tape that can store 
v e r y . 1 . a r d e a m o u n t s o f i n f o r m a t i o n ? fo u t a t a p e m u s t fo e m o u n t e d 
onto a tape drive whenever it is to be used* DECtae© is a 
special form of madnetic tape desidned especially for DECsystem 
m a c h i 1 1 e s * A .!. 1 o t t h e p fo y s i e a 1 p a r t s o f t h e c (!) m p u t e r 


collectively referred to as the computer's hardwa re* 
STOR I NG INFORMAT 1 ON 
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Each piece of information fed into the computer consists of 
a number or a character* The characters used are the letters 
( A ™ Z > ? t h e d i d i t s < 0 ™ 9 ) a n d t h e s p e c i a 1 s y m fo o 1 s ™ ? / ? )fc ? $ ? , .. 

' " and + * Any information combi nind these characters is 

c a 1 .1. e (.i a .1. )■■■• h a 1 1 u m e r 1 c d a t a * A 1 p 1) a n u m e v' i (!.' d a t a i s r e p r e s e n t e d i n 
the ^ computer or in storage in a special coded form* The code 
used by the DEC™ 10 is called ASCII ? “American Standard Code for 
1 n f o r m a t i o n 1 n t e r c h a n d e * * 


£7 l here are several terms used for measurind amounts of core 

a 8 storade* A fo t is the smallest unit of memory* It can store 

oii.l. y a zero or a one? :i.»e* on or off* The number of bits 

4 0 n e e d e d t o rep r e s e n t o n e a 1 p h a n u m e r i c c h a r a c t e r i !•; c a 1 1 e d a fo y t e * 
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4:1. Another measure commonly used is the amount of me mors heeded to 

42 represent a number? called a word of memory* On the DEC™ 10? a 

43 byte consists of 7 bits and a word contains 36 bits? i*e* 5 

44 bytes + .1. extra bit* The only other measure we need is a large 

43 one* K is an abbreviation for 1024 words of memory? :i.*e* 4K 

46 means 4096 words of core* 


TALKING ABOUT INFORMATION 

47 We now need some terms for discussing the information 

48 stored in memory (or on a peripheral device)* A record is a 

49 collection of words? normally the amount of information to be 

50 input or output at one time* When we store information on tape 

51- " or disk? we store it in groups of related information known as 

52 f i les * A file can be a data file (containing alphanumeric or 

5 3 n u m e r i c i n f o r m a t i o n t o b e p r o c e s s e d I a t e r ) ? a program file 

54 (containing a set of instructions telling the computer exactly 

55 what you want it to do) or it may be a text file (containing 

56 alphanumeric information to be written out later)* The size of 

57 the file is measured in blocks ? a unit consisting of 128 

58 computer words* 


GETTING ON 

39 There are two techniques for using the computer* Batch 

60 processing allows you to turn in a program? have it run and 

61 later pick up the results* The alternative is to use a 

62 timesharing system? where you use a terminal to input programs 

63 and? without much waiting? get the results typed out at the 

64 terminal* A timesharing system is designed so that users 

65 alternate use of the CPU in rapid succession in such a way that 

66 each user seems to have complete control of the computer* 


6 7 T h e c o m p u t e r .i. s u s e d b w w r i t i n g a P r o g r a m a c c o r d i n g t o o n e 

i 68 of several systems of syntax or “grammar"*" These systems are 
6 9 c a 1 1 e d e r o g r a m m i n g 1 a n g u a g e s * T here a r e s e v e r a 1 t y p e s o f 

7 () p r o g r a m m i n g 1 a n g u a g e s ? t h e m o s t b a s i c i s t h e m a chi n e ' s o w n s e t 

7 1 o f i n s t r u c t i o n s ? g e n e r a 1 1 y c a 1 1 e d m a c h 1 n e 1 a n g u a g e ♦ S i n c e t h i s 

7 2 1 a n g u a g e c o n s i s t s e n t i r e 1 y o f n u m b e r s ? i t i s v e r y c o n f u s i n g and 

73 so m e p r o g r a m m e r s p r e f e r a n a s s e m b 1 y 1 a n g u a g e ( a s y m b o 1 i c for m o f 

74 the machine language)* On the DEC-10? the assembly language is 

75 called MACRO* An assembly language uses abbreviations (called 

76 mnemonics ) to represent instructions instead of numbers? as 

77 machine language uses* For instance? ADD in MACRO and 270 in 

78 machine language both instruct the computer to do an addition* 

PROGRAMS? PROGRAMS 


79 

80 
81 
82 

83 ; 

84 

85 


Other programmers prefer a higher level 
I a n g u a g e t h a t i s mo r e 1 i k e a 1 g & b r a or English 
in one of these languages are often called 
These programs must be 
language? before they can be 


lang uage ? 
Program 


a 

written 


s o u r c e p r pgr a ms * 


compl led ? translated into machine 
program that actually does 


run • 


A 


this translation is celled a compl 1 er * Each higher level 
language has its own compiler* The compiled version of a source 
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processing* This waiting line is called the eueue or the 
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1 it tie 
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more 

users 


433 s i c Hopefully? the terms in this memo will have a 

134 meaning now* More information is available for be; 

135 of the Syracuse University Computing Center ( SI.JCC ) * Many S1JCC 

13-6 •••• memos are for sale in the Business Office? Room 122 Machinery 

137, Hall* Others are available free of charge in the AID Office ? 

138 room 116 Machinery Hall (AID = Assistance? Information? 

139 Documentation)* Help with computing problems is also available 

140 in the AID Office* 
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E a c h p r o g r a m m :i. n g 1 a n g u a g e u s e s d 1 f f e r e n t w o r d s o r s y m b o 1 s 
to represent the same instruction » A method for solving a 
particular problem that is General enough to be translated into 
any of the programming languages is called an a 1 do r i thm * A 
program that is stored on the computer and made available to all 
the users is often called a syst em program * Some system 
programs can aid you in manipulating? correct! ng or analysing 
your files arid programs* These are called u tilities* The 
e 1 1 1 i r e c o .1. 1 e c t i o n o i s y s t e m p r o g r a m s ? u t i 1 i t i e s a n d c o m p i .1 e r s 
generally referred to as the computer's software* 

MURPHY ' S LAW 


IB 


<!> ^ W h e n p r o a r a m m i n g a c o m p u t e r ? y o u m u s t r e m e m b e r Mu rphy ' s L a w 

99 which states that if anything can go wrong with your program? it 

1. 0 0 p r o b a b .1. y w i 1 .1. g o w r o n g * W h e n t h i s o c c u r s y y o u m u s t s i t d o w n a n d 

1.01 test the program? study the program and agonize over 

1. 0 2 u n t i .1. t h e r e a s o n s f o r e r r o r a r e d i s c o v e r e d * T h i s 

1. 0 3 c a 1 .1 e d d e b u g g 1 n g * 
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am :i. n 

a rts * 


'• you to refer to a 
it* On the DEC- 10 


particular file? you need a 
a file spe c .1 f 1 c a 1 1 o n is made 

name 


!f. S 

f was 
i:i. nd 
use ? 
of a 
to the 


u s e r - c r e a t e d f ilename a n d a " 1 a s t 
ns ion * The extension indicates the type of file? 
data file or a text file? which programming 
written in? etc* Since there will be files that 
others using and other files that you don't want 
t n e D C — 1 0 a 1 .1. o w s y o u t o p r o t e c t w o u r f 1 .1. e s * T h e 
particular file is a three digit number which 
computer which users you will allow to use the 
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i !"i e D E (..• — .1. 0 h a s a s y s t e m p r o g r a m c a 1 1 e d t h e monl tor w h i c h 
controls the communication between you and the computer* The 
monitor fetches system programs and starts them for you* When 
y o u w i s h t o b e g n w o r k i n g a t a t e r m i n a I ? y o u m u s t i d e n t i f y 
yourself to the monitor using your account number? also called 
wour project? programme r num bers or PPN* This process is 
referred to as logging in* 


prompt (a 


0 1 "i c e y o u h a v e .!. o g g e d i n ? t h e m o n i t o r p r i n t s 

® h w f s i c n :i. n o i c a t e s t h a t 1 1 i s r e a d y t o a c c e p t a c o m m a n d * 

You may now use one of about 110 m o n 1 1 o r c o m m a n d s that allow you 
t o c r e a t e f i 1 e s ? r u n p r o g r a in s o r a s k f o r p r i n t - o u t * I n m a n y 

m o n 1 1 o r c o m m a n d s ? y o u a r e a .1. .1 o w e d t o o m i t c e r t a I n p a r t s o f t h e 

command line* In this case? the DEC- 10 has a series of defaults 
or assumed values for the missing information* Since users must 
share most of the per xi" - hera,!. devices? some DEC— 10 devices have a 
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ABSTRACT: 

This memo discusses the differences between FORTRAN on the IBM 
System/370 and on the DECsystem- 1 0 . The differences involve 
features available in each version of FORTRAN that are not available 
in other versions. The intent is to illustrate problems and 
required changes in converting a FORTRAN program from one machine to 
another, and to help users decide which version of FORTRAN would be 
best for their purposes. 
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Introduction 


The Syracuse University Computing Center has available for 
users five versions of FORTRAN, two on the DECsystem-1 0 and three on 
the IBM/370. On the DEC-10 are two very similar versions, FORTRAN- 
10 and FORTRAN-MO . FORTRAN-10 includes all of FORTRAN-MO; plus it 
does code optimization (and therefore uses more memory). In this 
memo, these two FORTRANs will be referred to as DEC-10 FORTRAN 
unless a difference is being discussed. The IBM/370 has IBM’s two 
FORTRANs, level -G and level-H. Level H of IBM FORTRAN includes all 
of level G and has code optimization features. In this memo, the 
name FORTRAN-G refers to both levels G and H. The fifth FORTRAN 
compiler is called WATFIV. WATFIV is a high speed compiler with 
descriptive error messages making it good for debugging. 

This memo describes major differences in FORTRAN on the two 
machines. Also included are brief descriptions of features that 
vary from version to version. Since this memo is a summary of 
differences, users are advised to consult the appropriate manual 
(all are in the AID Office) before using any features they are 
unfamiliar with. 


Comparison of IBM/370 and DECSYSTEM-10 

IBM/370 

Number of bits per word 32 

Maximum integer values 2, 1 M7 , M83 , 6M7 

(2**3 1-1 ) 

Real number magnitudes 10**-78 to +75 

Real number significant 

digits 7.2 (decimal digits) 

Double precision 

significant digits 16.8 (decimal digits) 


DEC-10 

36 

3M, 359, 738, 367 
( 2**3 5—1 ) 

1 o**- 38 to +38 
8 (decimal digits) 
16 (decimal digits) 


Number of characters that 

can be stored in one word M 



Conversion Between IBM/370 and DEC-10 

The major conversion problems occur when dealing with input and 
output. Each version of FORTRAN uses logical unit numbers to 
determine where flata will come from or go to. Each logical unit 
number used must be associated with a particular data set or data 
file (some numbers have defaults). The way in which the association 
is made is different on the two machines. On the DEC-10, the 
programmer includes an OPEN statement in his FORTRAN program (OPEN 
or CALL DEFINE FILE if direct access I/O is desired) . On the 
IBM/370, however, the association is made on a DD (data definition) 
JCL card. The logical unit numbers available for FORTRAN-G are 1 
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through 99, for DEC-10 FORTRAN, 1 through 63, and for WATFIV, 1 
through 16. 


Logical Unit Numbers 
JBM/370 

1 card reader 

2 card punch 

3 line printer 
4-99 assignable 


and Default Devices: 
WATFIV 

1 card reader 

2 card punch 

3 line printer 
4-16 assignable 


DEC-10 

1,3,5 teletype 
2 card reader 
4 console teletype 

6 paper tape reader 

7 paper tape punch 

8 display 
9-15 DECtape 
20-24 disk 

19 assignable 
20-24 disk 
25-63 assignable 


Another difference between the machines is the character 
representation. IBM uses a representation referred to as EBCDIC 
which uses 8 bits per character, allowing 4 characters per word 
(variable or array element). The DEC-10 on the other hand, uses 
ASCII representation, 7 bits per character, and allows 5 characters 
per word. The difference in the number of characters per word is an 
important conversion consideration. 


Differences in Library Functions 


Since FORTRAN-G has C0MPLEX S 16 and INTEGER*2 variable types 
(not available in DEC-10 FORTRAN), there are library functions for 
these types. There are also several double precision functions in 
FORTRAN-G that are not available in DEC-10 FORTRAN. 

The arcsine and arccosine functions are named ARSIN and ARCOS 
in FORTRAN-G, but they are named ASIN and ACOS in DEC-10 FORTRAN. 

FORTRAN-G has two groups of functions not available in DEC-10 
FORTRAN: an error function and gamma and log-gamma functions (all 
with various types),. 
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All of FORTRAN-G’s trigonometric functions take arguments 
measured in radians; DEC-10 FORTRAN has, in addition, two functions 
(SIND and COSD) whose arguments are measured in degrees. 

For the fourteen most common FORTRAN-10 (not FORTRAN-40) 
functions, the programmer is allowed to use a "generic" name 
whatever the numerical type of the argument. For instance, if the 
ABS (absolute value) function is used with integer or real or double 
precision variables, the FORTRAN-10 compiler will generate a call to 
the appropriate function. 

The WATFIV library functions are the same as those of FORTRAN- 

G. 


Special Features of FORTRAN-1 0 and FORTRAN-MO 

1. More than one statement may be written on the same line, 
separated by a semicolon, e.g. X=0;Y=3. (WATFIV also has this 
feature, but FORTRAN-40 does not.) 

2. Two additional logical operators are provided, .XOR. and .EQV.. 
The EXCLUSIVE OR (.XOR.) will produce a true result if one but 
not both of the logical expressions it combines is true. 
EQUIVALENCE (.EQV.) is the logical analogy to ,EQ.. 

3. The logical relations ,EQ. and .NE. may be used with complex 
variables and constants. 

4. Symbols may be used in place of the logical relations, i.e. 

.EQ. , .NE., .LT. , .LE. , .GT., and .GE. become ==, #, <, <=, >, 

and >= respectively. 

5. Literal, octal, and logical constants may be used in 

expressions, e.g. 

IF(X.EQ. ’STOP* ) GO TO 999 
Z = X + "1776 

I = 1 0* ( J . EQ. 1) 

When a logical value is used in an arithmetic statement, .TRUE, 
has the value -1 and .FALSE, has the value zero. 

6. Logical operators may be used on numerical variables or 

constants, in which case the operation is performed between 
corresponding bits. 

IF L=6, then the expression L.OR.IO has the 
value 14 

L 0110 (base 2) 

.OR. 1010 (base 2) 


1110 (base 2)=14 (base 10) 
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7. Arrays may be dimensioned to begin with a subscript other than 
1. For instance, DIMENSION A(-5/10) sets up a sixteen element 
array whose first element is A ( — 5 ) • 

8. Arrays can have any number of subscripts (if space allows). 

9. Subscripts used to address an array element may be real 
constants or expressions (FORTRAN-10 only). 

10. Object-time dimensions. When dimensioning a dummy array in a 
subprogram, only a 1 is required for each subscript. When the 
subprogram is called, the dimensions will become the dimensions 
of the array argument supplied, e.g. 

SUBROUTINE SUB(B) 

DIMENSION B( 1 ) 

In this case, the argument to subroutine SUB can be a one- 
dimensional array of any length. 

11. Variables in blank common as well as those in named common may 
be initialized in a BLOCK DATA subprogram (WATFIV also allows 
this) . 

12. A character array may be initialized in a DATA statement using 
one long quoted string, i.e. the string does not need to be 
separated into word-length strings. 

13. Computed GO TO statements may use either an integer variable or 
an integer expression, e.g. GO TO (10,20,30), NTB-1 . 

14. When inputting a FORTRAN program from the terminal, atab may 
be used to skip to the statement field. For a continuation 
line, the tab is followed by a single digit, then the remainder 
of the statement. 

15. DO loop parameters may be positive or negative, constants or 

expressions. FORTRAN-10 also allows real constants or 

expressions, but these values are truncated before use. 

DO 1 I=-1 0, J+2 , 3 

DO 1 1=10, 2, -2 

16. FORTRAN-1 0 allows IBM type specifications: REAL*4, REAL*8 , 
INTEGER*4 , etc. However, since some of these types are not 
available, the type may not be as prescribed in IBM FORTRAN. 
In particular, INTEGERS and L0GICAL*1 both define full, word 
variables in DEC-10 FORTRAN (a warning message is given). 
Also, C0MPLEX*1 6 defines a single precision complex variable 
(with a warning). FORTRAN-40 only allows those types that are 
valid DEC-10 FORTRAN types. 
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17. TYPE<ACCEPT> Two special input/output statements for terminal 
I/O are provided. TYPE and ACCEPT statements automatically 
refer to the teletype. 

18. DEC-10 FORTRAN allows free-field formatting for input and 
output. The user does not need to specify the size, but merely 
the type of field for all types except alphabetic (A format), 
e .g . 

TYPE 1 0 , X , Y<I 
10 FORMAT (2F , I ) 

19. An 0 format is available for output of octal data (FORTRAN-G 
and WATFIV have a Z format for hexadecimal output instead). 

20. A special character ($) may be used in format statements to 
suppress the carriage return at the end of the line. This is 
helpful in writing interactive programs, e.g. 

TYPE 39 

39 FORMAT ( * A = ' ,$) 

ACCEPT MO, A 
MO FORMAT(F) 


This series of statements could cause the input of a value for 
A to appear as: A=39.2, rather than: 

A = 

39.2 

21. When using sequential I/O, in addition to REWIND, BACKSPACE and 
END FILE statements, DEC-10 FORTRAN provides a SKIP RECORD and 
an UNLOAD statement. 

22. REREAD. DEC-10 FORTRAN provides this special statement, which 
allows the program to read again the most recently read record 
according to a new format. FORTRAN-G (at SU) allows this 
feature, using a subroutine named REREAD. 

23. ENCODE and DECODE statements cause conversion from binary to 
ASCII or from ASCII to binary. These features are similar to 
use of the CORE subroutine in FORTRAN-G and to the "core-to- 
core I/O" feature of WATFIV. 

2M. PAUSE ’string’. This statement causes the program to stop 
execution, print out the quoted string at the terminal and 
await user response (FORTRAN-G and WATFIV have a similar 
statement, but the computer operator must respond). 
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25. Direct Access I/O is provided, but rather than using a DEFINE 
FILE statement (as in FORTRAN-G and WATFIV), the programmer 
either calls the DEFINE FILE subroutine or specifies random 
access in an open statement. 

26. Optimization of code is performed by FORTRAN-10 (but not by 
FORTRAN-40 ) . 

27. A powerful "Dynamic Debugging Technique" (known as DDT) is 
provided. DDT is designed to get rid of "bugs" in programs 
( see DDT manual) . 


Special Features of WATFIV 


1 . 


Multiple statements on a card 
semicolon (FORTRAN-10 also allows 


are al lowed , 
this) . 


separated by a 


2. Multiple assignment statements. The same value may be assigned 
to more than one variable by using something of the form: 
X=Y =0 . 

3. Arrays can have a maximum of seven subscripts (FORTRAN-G also). 

4. The features of a DATA statement and any type specification 
statement may be combined, e.g. INTEGER I,J/1,2/ (FORTRAN-G 
also allows this) . 

5. PRINT, PUNCH, READ. These special I/O statements are provided, 
for which appropriate logical unit numbers are assumed 
(FORTRAN-G also) . 

6. Z format. Hexadecimal output is accomplished with this format. 
FORTRAN-G also has Z format, while DEC-10 FORTRAN has 0 format 
for octal output. 

7. Hexadecimal constants are allowed only in a DATA initialization 
statement . 

8. Format-free output. WATFIV eliminates the need for format 

statements by providing default fields (except for A format), 
e.g. PRINT, X, Y, I 

9. Expressions are allowed in an output list as long as the 

expression does not begin with a left parenthesis. 

10. CHARACTERS type specification. This special type 

specification defines a variable which can hold n characters 
and allows the variable to be initialized by a single long 
quoted string, e.g. CHARACTER* 1 0 ABC/ » ALPHABETIC » / 

11. Core-to-core I/O. WATFIV has special forms of the READ and 

WRITE statements allowing formatted conversion of data without 
physical input or output. These statements are READ (var, fmt) 
list and WRITE (var, frat) list, where var is a character 

variable or array and otherwise the statements are normal . 



LF 1 9 


7 


LF-19 


This feature is similar to ENCODE and DECODE statements in DEC- 
10 FORTRAN and the use of the CORE subroutine in FORTRAN-G. 

12 . Three special variable types are provided: LOGICAL*!, 

INTEGER*2 and C0MPLEX*16. Also, the DOUBLE PRECISION 
specification (same as REAL*8) is allowed (FORTRAN-G also has 
these) . 


Special Features of FORTRAN-G and FORTRAN-H 


1 . The combination of the features of a DATA statement with a type 
specification statement is allowed, e.g. REAL X, Y/1 . 2, 3. 4/ 
(WATFIV also allows this). 

2. Arrays can have a maximum of seven subscripts (WATFIV also). 

3. PRINT, PUNCH and READ. These special I/O statements are 
provided, for which the appropriate logical unit numbers are 
assumed (WATFIV also has these statements). 

4. Z format allows hexadecimal output. WATFIV also has this, 
while DEC-10 FORTRAN has 0 format for octal output instead. 

5. Hexadecimal constants are allowed only in a DATA initialization 
statement . 


6. Three special variable types are provided: L0GICAL*1 , 

INTEGER*2 and C0MPLEX*16. Also the DOUBLE PRECISION 
specification (same as REAL*8) is allowed (WATFIV also has 
these) . 

7. The dollar sign ($) is considered alphabetic, i.e. variable 
names may begin with it. 

8. Function type may be specified inside the function, e.g. 

FUNCTION INT(X) 


REAL*8 INT 

9. FORTRAN-G has a debugging feature which aids in analyzing 
problem programs. 

10. A subroutine named REREAD allows a program to read the same 
record twice. (See Memo LF 1 3 — Aid Office.) 


11. Another subroutine, CORE, allows formatted I/O operations to or 
from a variable (see Memo LF13 — Aid Office). This is similar 
to ENCODE and DECODE statements of DEC-10 FORTRAN and to "core- 
to-core I/O" in WATFIV. 
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The DECsys tem- 1 0 at Syracuse University may be used for both 
timesharing applications and for batch programming . To use the DEC- 
10 for timesharing applications you must be able to: 

1) sign on, i.e. establish communication with the computer through 
a terminal, 

2) run certain system programs to create, edit and manipulate 
files, and 

3) sign off, i.e. terminate contact with the computer when you are 
through with your work. 

This memo provides the basic information you will need to do 
each of these things. More advanced information for timesharing 
users is provided in CCIS Memos SI27, "DECsystem- 1 0 Reference 
Sheets” and UA29, "DECsystem- 1 0 Utilities”; batch users should see 
CCIS Memo SI19, "DECsystem- 1 0 Beginners Guide to Multi-Programming 
Batch.” 


Before you can begin to use the DECsystem-10, you must have a 
valid account number. See the assistant business manager, Room 122 
Machinery Hall, to apply for your incentive account, or get an 
account from your instructor for any course requiring the use of the 
DEC- 1 0 . 


II. How to Sign on 

Login and sign-on are two terms which are used interchangeably 
as names for the process of establishing communication with the 
computer from a terminal. This section of the memo describes in 
detail the steps you need to perform to complete the login process. 
It also tells you what you should do if you have problems during 
log in . 

The first thing you must do to sign on to the DEC-10 is locate 
a terminal. There are approximately 70 Decwriter terminals located 
at various places around campus. A list of terminal locations is 
available outside Room 122 Machinery Hall. 

The keyboard of a Decwriter terminal looks like this: 
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The tops of the keys show the full ASCII (American Standard 
Code for Information 2 nterchan S e ^ character set. This is the 
character set used to transmit information to and from the DEC-10. 
The yellow characters on the keyfronts are the APL special 
characters and should be ignored by DEC-10 users. 

Once you have found a terminal and familiarized yourself with 
the keyboard, you should proceed to sign on as follows: 

1. Check all 8 buttons at the left of the keyboard. Only the one 
marked 300 should be down. The other 7 should be up. (To change 
the state of a button, press it once.) 

2. Press ON (upper left of keyboard). The red light marked STD 
CHAR SET will light indicating that the ASCII character set will be 
used . 

3. Press the RETURN button. The computer will print a one line 
response followed by a period (prompt) at the left margin. The 
response should look something like this: 

09E)SYRACUSE UNIV. TIMESHARING 


4. After the period (prompt) prints, type the word login, a space, 
your account number and then press RETURN. For example, if you have 
account number 123*1,56 this step would be as follows: 

.login 1234,56 

Note that your account number consists of two parts. The first 
part is your project number, and the second part is your programmer 
number. The two parts of the account number must be separated by a 
comma as shown above. 


After you press RETURN, the word LOGIN and your account number 
will be printed again and then another message will print at your 
terminal. It will look something like this: 

JOB 25 Syracuse Univ 6.03 TTY15 

JOB 25 indicates the job number assigned to you by the system. 
Syracuse Univ 6.03 is the name of the current version of the 
monitor, (the system's control program) and TTY15 is an 
identification for the terminal you are using. 


Next the computer types Password: to indicate that it is ready 
you to type in the password which was assigned to you when you 
given your account. When you type in your password, it will 
not print at the terminal. Printing is suppressed for purposes of 
security so that anyone picking up your discarded output or looking 
over your shoulder will not be able to learn your password. 
Remember to press RETURN after your password, and at the end of any 
line you type to the computer. 


5. 

for 

were 
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If you are successful in 
day and any important messages 
followed by a period (prompt) at 
have completed the login procedure 
with the computer. 

Below is a sample of the 
1234,56. The underlined information 


the time of 
will print, 
this point you 
begin working 


login process for account number 
was typed by the computer. 


all of the above steps, 
from the operator 
the left margin. At 
and are ready to 


Q9E) SYRACUSE UNIV. TIMESHARING 


.login 



LOGIN 

1234,56 


JOB 25 

Syracuse Univ 

6.03 TTY15 

Passwo 

rd : 


TWT~ 

1 6-Jun-77 

Thur 


Problems at Sign-on 


While the login procedure is fairly straightforward if all goes 
well, there are a number of things that can go wrong. If youpress 
RETURN and get no response at all when you first begin to login, it 
may mean that the PDP-'i 1 , the computer which communicates between 
terminals and the DEC-10, is not functioning. If you get the 
message SYRACUSE UNIV. TIMESHARING, and then type LOGIN and get the 
message 7DECSYSTEM-1 0 NOT AVAILABLE, it means that the DEC-10 
computer has some kind of problem and is not available for public 
use. If either of these problems occur, call the dispatcher, ext. 
3-3245, for information about how long the computer will be 
unavailable . 

When both computers are available, you may still have problems 
if you enter the wrong account number or password. If you get the 
message : 

7LGNIET INVALID ENTRY-try again 
# 

try reentering your account number and password by typing your 
account number after the # and your password after the request 
Password:. Do not type LOGIN again. If trouble persists, check 
with the AID staff (Room 116 Machinery Hall) to see if you are 
entering your number improperly. If you are still unable to sign 
on, see the assistant business manager (Room 122 Machinery Hall) to 
verify that your account number and password have been entered into 
the accounting system correctly. 


Changing Your Password : 


If at any time you believe that someone else may have knowledge 
of your account number and password, you should change the password. 



i n 

f act , 

i t i s a 

i n te 

r v a i s 

to insure 


Your 

password 

that 

you 

want to ch 

account 

number wh 

you 

wo u 1 d 

enter the 


od practice to change your password 
e security of your account. 


at regular 


rfla y changed only when you login. To 
ange your password, append /PASSWORD 

en you login. If you have account number 
i o llowi ng : 


indicate 
to your 
1234,56 


LOGIN 123*i, 


CRI 


When the system responds 
PASSWORD: 


enter your old password. 
New password: 


computer 


will then print 


Yo u 

u a s sword . 
would be 


should then 
For example, 


cuter tre characters you want for your new 
L ° c ' nan « e your password to LIN, this line 


Mew p 


a s s w o r a 


d 


te that the printing of the 
"-Tore, you must ;>e very careful 
ousoy the output so others cannot 


new password is not suppressed, 
uo blot it out or otherwise 
learn your new password. 


.this new password which you just entered 
cine you try to login. 


must be used the next 


The Monitor 


When 


you 


i.ntact with th 

s the controlling program 
nterpret commands to select 
counting information and 


which art 
user 


necessar y 


ave - ' ,m Pieted logging in to the DEC-10, you are in 
system program known as the monitor. The monitor 
on the DEC-10. Its function is to 
user programs to be run, to gather 
- Ln general to perform all those tasks 


keep the system running smoothly 


for all 


On e o f 
the monitor : 
which is pr 
the monitor, 
umbers, etc. 


u ie ways you e... ■' tell that you 
s by the per- od prompt which _t 
inted at the end of login, for 
Other programs have different 


e . communicating with 
hints. The per-L.- 4 
example, was printed by 


prompts, such as * n ne 


i Pve i you may pntm W- ! - uh the monitor, i.e. at monitor 

- ' - 1 . r ei,ter ° 1 - numoer or monitor command' 3 von 

t h fse -tivitiPs°f ra: ' S r 0r H y0U may sign off from the system. Each of 
a “ b i vlhlej W1 be described later in this memo. 
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IV. How to Sign-off 


Before going into any detail on how to use the DEC-10, let’s 
discuss how to terminate the connection between your terminal, your 
account number and the DEC-10. This process of terminating 
communication between you and the computer is known either as logout 
or sign-off. 

The simplest way to sign off is to type K/F in response to the 
monitor prompt. K means run the KJOB (Kill JOB ) program, and F 
means try to do a fast logout and save all files which have been 
created. This fast logout will work unless you have created too 
many files and are over your allocated storage quota. Section IX 
of this memo describes what to do when this occurs. 

After you type K/F and press return, information will print out 
telling you the date and time, how much file storage-space you used, 
how long your job ran and what your charges are. The sign-off and 
associated information look like this: (Underlined information is 
typed by the computer) . 

.K/F 

Job 25, User [ 123*1,56] Logged off TTY 1 5 1 442 l6-Jun-77 

Saved all files (50 blocks) 

Runtime 2.52 Sec 

CHARGE: $0. 1 4=$0 . 06 ( C) +$0 . 06 (P )+$0 . 02 (K ) 

Y-T-D ACCOUNT USE: WTt 


The amount you are charged for using the computer is based on 
three things. The first is connect time (C) which is the elapsed 
time from the beginning of a terminal session to the end. The 
second is CPU or central processing unit time (P). This is a 
measure of the actual amount of computing done by your job. 
Finally, you are charged for the amount of core your job used when 
running (K). The total charge for your job and the charge broken 
down into each of these components are reported on the line labelled 
CHARGE. The last line tells you the per cent of your total account 
used so far this year. 


V. Naming Files 

The DEC-10 is set up so that all programs and data are stored 
as files. A DEC-10 file is simply a collection of information that 
is given a name and stored as a unit. Because all programs and data 
are stored as files, it is essential that you learn to name files, 
create files, edit files, and perform other functions with files. 

File names on the DEC-10 have two parts. The fi£,st part of the 
name is the actual name of the file; the second part of the name is 
called the file extension and indicates what kind of file it is. 
The name part of a file name may be from 1-6 letters or digits, 
while a file extension has from 0-3 letters or digits. The file 
name and extension, if any, must be separated by a period. 
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The choice of a file name is entirely up to you as a 

programmer. Generally it is a good idea to choose a name which 

indicates the purpose or contents of the file and an extension which 
indicates the kind of file it is. Some standard file extensions and 
their meanings are: 

.FOR Source file in FORTRAN language 

.BAS Source file in BASIC language 

.CBL Source file in COBOL language 

•ALG Source file in ALGOL language 

.DAT Data file 

.REL Relocatable binary file 

.TMP Temporary file 

If you write a FORTRAN program to calculate an average, for 
example, you might want to call it AVG.FOR or AVR AGE . FOR , or some 
similar name indicating its purpose (to calculate an average) and 
its type (FORTRAN). Similarly, a COBOL program for processing 
payroll data might be called PAYROL.CBL while the data it uses might 
be in a file called PAYROL.DAT. 

A file on the DEC-10 also has as part of its full name the 

project-programmer number (account number) of the person who owns 
it. This project-programmer number part of the file name doesn't 
need to be specified when you reference your own files. However, it 
is a part of each file name so that there is no possibility of 
confusing your file with a file of the same name and extension but 
belonging to another user. That is, if your project programmer 
number is 1234,56 and you have a file named MYPROG. FOR , the full 

specification for your file is MYPROG. FOR [ 1 234, 56] . Since your file 

is the only one with your account number as part of its name, there 
is no chance for confusion with any other file. 


VI. Creating and Editing Files 

The easiest and most commonly used way to create files on the 
DEC-10 is to use a text editor. This section of the memo describes 
how to use SOS, a line oriented text editor which may be used to 
create and edit files. More details on the use of SOS may be found 
in CCIS Memo TX-2 , The SOS Manual. 

Since SOS is simply a program which manipulates text, the first 
thing you have to der to use SOS is give the monitor command which 
runs the SOS program. This is done by entering the word SOS after 
the monitor prompt. 

You must also give the name of the file you want to create or 
edit. If you give the name of a file which has not been created 
previously, SOS will assume that you want to create a new file with 
that name. If you give the name of a file which already exists on 
disk, SOS assumes that you want to edit that file. 
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Input Mode 

First let’s consider using SOS in input mode to create a new 
file. Suppose you want to create a file called TESTA. FOR. To 
create this file, type 

.SOS TESTA. FOR 


and 

press RETURN. SOS 

wi 

11 respond with 

a 1 

ine number 

ind 

icat 

ing 

tha 

t it is ready for you 

to 

begin. Type in 

the 

first line 

o 

f your 

fil 

e and press RETURN. 

SOS 

will print the 

nex 

t line numb 

er 

and 

you 

can 

then enter the next 1 

ine 

of your file. 

Con 

tinue enter 

ing 

li 

nes 

one 

by one after the li 

ne 

number prompt un 

til 

your entir 

e file 

has 

bee 

n entered. 









When you have ent 

ered the last line 

! Of 

your file, 

pr 

ess 

the 

esc 

ape key (labelled ESC) 


A $ will print, 

and 

then the * 

pr 

ompt 

on 

the 

next line. This ind 

ica 

tes that SOS has 

; le 

ft input mode, 

and 

i s 

now 

in edit mode. That i 

S, 

the entries you 

make now wil 

1 

not 

be 

con 

sidered lines of yo 

ur 

file, but will 

be 

interpreted 

by 

SOS 

as 

ins 

tructions on how to ed 

it 

your file. The 

ed i 

t mode prom 

pt 

is 

the 

s while the input mode pr 

ompt was a line number 

• 




The following exam 

pie 

shows SOS bei 

ng 

used in input 

mode 

to 

ere 

ate a file. After the 

fi 

le information was 

entered , ESC 

( wh 

ich 

pr i 

nts as a $) was pre 

ssed to end input m 

ode 

and enter 

ed i 

t mode. 

The 

underlined informatio 

n was typed by the 

com 

puter . 





_^SOS MYFILE.DAT 
Input: MYFILE.DAT 
00100 THIS IS A TEXT FILE 
00200 WHICH ILLUSTRATES 
00300 THE USE OF SOS 
00*100" TO INPUT A FILE. 

00500 $ 

If- 


Note that the $ prints when the escape character is pressed. In 
this memo, $ represents the escape character, not a dollar sign. 


Edit Mode 


Edit mode is entered by pres 
giving the SOS command and an old file 
is the *. While in edit mode you m 
lines, delete lines, replace lines, o 
following is a list of some edit 
explanation of how they are used. 


sing ESC in input mode, or by 
name. The edit mode prompt 
ay do such things as print out 
r leave SOS entirely. The 
mode commands along with an 


P Print at the terminal the line or lines indicated. To print 
line 100, use 
P100 

To print lines 200 to 400, use 
P200 : 400 
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D Delete from the file the indicated line or lines. To delete 
line 100, use 
D 100 

To delete lines 300 to 600, use 
D300: 600 

I Insert a line. For example, to insert line 350 you would type 
1350 and press RETURN. The number 00350 will print at the 
margin and then you may enter the line you wish to insert. If 
you already have a line numbered 350, SOS will interpret the 
command 1350 to mean that you want to insert a line after line 
350 but before the next line in your file, and will choose an 
appropriate line number for you. Normally the insert command 
will allow you to insert only one line at a time. However n 
there is room to insert more than one line (incrementing by 
100), SOS will remain in input mode until escape is entered or 
until the next line of the file is reached. SOS also enters 
input mode after the insert command if the line you are 
inserting is the last line in the file. This allows you to add 
lines to the end of a file. 

R Replace the indicated line or lines. To replace line 100, 
enter 
R 1 00 

SOS will respond 00100 and wait for you to enter the 
replacement line. To replace lines 200 to t| 0 0 , enter 
R200: 400 

Note that the replace command functions like the insert 
command in that SOS will enter input mode if there is room for 
multiple insertions. 

S Substitute one character string for another. To use this 
command, type an S followed by the old character string, the 
escape character, the new character string, the escape 
character and then the line number in which the substitution is 
to take place. For example, to change the word FOR in line 600 
to the word TO, the following command would be used ($ 
represents the escape character) 

SFOR$TO$600 

Be sure to use enough characters to uniquely identify the item 
you want changed, because the substitute command changes all 
occurrences of the old string to the new string. 

E Exit from SOS and save t v e file (with line numbers). This is 
the normal way to exit from SOS. 

ES Strip line numbers and then exit and save the file. This 
command should be used for creating the final copy of data 
files and text files. It is also an easy way to renumber a 
file since if you reenter SOS to edit a file which has had ^he 
line numbers stripped, SOS will automatically generate a new 
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set of line numbers for the file. These new line numbers will 
start at 100, with increments of 100. 

Enter alter mode to edit character by character within a line 
of the file. To enter alter mode for line 300, type A300. 
Alter mode editing is described in the next section of this 
memo . 


Alter mode 

Sometimes when you have a few small changes to make to a line, 
it is easier to go directly into the line and change a few 
characters rather than replace the entire line or substitute for 
parts of the line. To do this, you use SOS in alter mode. 

Alter mode is entered from edit mode by giving the alter 
command followed by a line number. Once in alter mode you can move 
an imaginary pointer back and forth within the specified line to 
indicate where you want to change, delete or insert characters. 
There are four commands for moving the pointer, and several other 
commands to do the actual changes to the line. One major difference 
between alter mode and the other modes is that alter mode does not 
give prompts or print the users command. 

The alter mode commands to move the pointer are: 

space Pressing the space bar will move the pointer forward 

one character. 

backspace Pressing the backspace key will move the pointer back 

one character. 


L Typing the letter L will print out the entire line and 

return the pointer to the beginning of the line. 

S Typing the letter S followed by any character will 

cause the pointer to skip to the first occurrence of 

that character. If you want to skip to other than the 

first occurrence of a character, precede the S command 

with the number of the occurrence to be skipped to. 

For example, to skip to the third q in a line you would 
enter 3SQ. 

The next group of commands is used to make. changes to a line. 
These commands act on or before the character indicated by the 
pointer . 


Change the next characters. For example, CA will 
change the next character to the letter A. 3CXYZ will 
change the next 3 characters to XYZ. 


C 
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D 


I 


RETURN 


Delete the next characters. For example, D will delete 
the next character, while 3D will delete the next 3 
characters . 

Insert, before the next character, whatever is typed 
next. Stop inserting when the escape key or return is 
pressed . 

Leave alter mode and return to edit mode. 


Exercises 


The only way to really gain familiarity with a text editor is 
to use it, so a sample exercise for you to try at your terminal has 
been included. The left column of the following example is a series 
of commands to the various modes of SOS. (The SOS command is, of 
course, given to the monitor.) The right column describes the 
results of typing the corresponding lines of the left column. Try 
this exercise at a terminal. If you have any problems or don’t 
understand any of the results, reread the appropriate sections of 
this memo, or see CCIS Memo TX2, The SOS Manual, for more details on 
SOS. Remember that in this example, only what you enter is listed. 
The prompts from SOS and the monitor are not shown. 

Type this: To do this: 

INPUT MODE 


SOS FILEA.TST 
AAAAA 
BBBBB 
CCCGC 
DDDDD 
EEEEE 
$ 


(Press the escape key, not the dollar sign.) 
EDIT MODE 


P300 

P300: 500 

1100 

ABABAB 

D400 

E 

SOS FILEA.TST 
P100: 500 
R200 
ZZZZZ 
1500 
FFFFF 
GGGGG 
HHHHH 
$ 

D200: 500 
R 1 00 

123451234512345 
A 1 00 


print line 300. 

print lines 300 through 500. 

insert a line after line 100. 

delete line 400. 
exit from SOS. 
reenter SOS (edit mode), 
print the whole file, 
replace line 200. 

insert lines 600,700,... 

Note that if there is room for the insertion of 
another line (incrementing by 100), then SOS 
will insert another line. 

(Press the escape key, not dollar sign.) 
delete 3 lines. 

replace line 100 with some numbers, 
enter alter mode for line 100. 
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<space><space> 

<bksp> 

L 

2S3 

CO 

D 

SI 

iOOO$ 

<cr> 

PIOO: 800 
E 


ALTER MODE - Note that commands do not print. 

press the space bar twice to move to the 3rd 
character of the line. 

press the backspace key to move back to the 2nd 
character . 

enter the letter L to print out the line and 

return the pointer to the start of the line. 

skip to the 2nd 3 after the pointer 

change it to a zero. 

delete the next character. 

skip to the next 1. 

insert 3 zeroes before the 1. (end the insertion 
by pressing the escape key.) 

press RETURN to end alter mode and return to edit 
mode . 

print the entire file, 
exit from SOS. 


VII. Commands 

When you type SOS followed by a file name, you are indicating 
to the monitor, or controlling program, that you want to run the 
program SOS. In other words, you are giving the monitor the SOS 
command. Since the command was given to the monitor, SOS is said to 
be run at monitor level. There are many other programs besides SOS 
which you may want to run at monitor level. These programs may be 
used to do such things as list the names of your files, type at the 
terminal the contents of a file, list a file on the line printer or 
delete a file which is no longer needed. Some of the more commonly 
used of these programs are set up like SOS so that they may be run 
using a command. Others do not have a specific command associated 
with them, but instead are run by using the R (run) command followed 
by the program name. This section of the memo describes some of the 
basic commands which may be given to the monitor. For more detail 
on these and other commands see CCIS Memo SI27, "DECsystem-1 0 
Reference Sheets" or the DEC-10 Operating System Command Manual. 


The DIRECTORY Command 


The directory command requests from the monitor a listing of 
the "directory" of your file storage area. That is, it asks for a 
list of the names of the files you have created and for some of the 
information associated with those files. To get a directory 
listing, type DIRECT in response to the monitor prompt as follows. 

.DIRECT 

(If you prefer, you may use the three letter abbreviation DIR 
instead.) The monitor response to the DIRECT command is to type at 
your terminal the names of your files, the written size of each in 
blocks, the protection codes associated with each file and the date 
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each 

file was 

created . 

These 

are all 

explained below. For example, 

if you have created 

two 

files , 

FI .BAS 

and FORM. FOR, and have edited 

FORM 

.FOR using 

SOS, 

the 

output 

from the directory command might look 

like 

this : 







.DIRECT 







FI 

BAS 


6 

<057> 

27-APR-77 DSKA:[1234,56] 


FORM 

FOR 


7 

<057> 

21 -MAY-77 


FORM 

QOR 


7 

<057> 

22-M AY-77 


Total of 

20 blocks 

in 3 files on 

DSKA: [1234,56] 


The first column contains the file names of all files in your 
storage area. The second column contains the extensions for these 
files. Although you only created two files, three are listed. The 
third file, FORM.QOR, is a backup file created by SOS. It contains 
a copy of your file FORM. FOR as it was before you edited it. Many 
other programs also create auxiliary or backup files which will show 
up when you give the directory command. These files usually have 
the same name as another file but a different extension. 
Information on how to delete these extra files is presented later in 
this section. 

The third column of the output tells the number of blocks 
required to store the information in each file. A block is simply a 
unit of measure which is equivalent to the space required to store 
640 characters. When files are written to disk, the amount of space 
they actually use is always greater than the size reported here. 
First, every file has an additional two blocks of system information 
associated with it. Second, space for files is always allocated in 
units of 5 blocks at a time. Therefore, a file like FI. BAS, whose 
size is reported as 6 blocks, will actually use 10 blocks -- 6 for 
data, 2 for system information and 2 empty. It is the space 
actually allocated to a file, or its allocated size, that is used in 
determining whether or not you have exceeded the file storage quota 
established when your account was set up. See Section IX of this 
memo for more information on storage quotas. 

The number in angle brackets in the fourth column of output 
gives the protection associated with each file. The protection code 
is simply a numeric indication of who is allowed to access your 
files. For details on protection, see CCIS Memo SI27, "DECsy stem- 1 0 
Reference Sheets (File Specifications)." 

The fifth column of the directory output lists the dates on 
which the files were created. DSKA : [ 1 234 , 56 ] , which appears at the 
top right of the output gives the system identification for the 
device on which your files are stored and gives your project 
programmer number. The summary line at the bottom of the output 
tells you the total amount of storage you are using. Remember that 
this is in written blocks, not allocated blocks, so the actual 
amount of storage charged to your account number will be greater 
than this. 
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The TYPE Command and the PRIMT Command 

The directory command gives you a list of the names of the 
files in your storage area. If you would like to list at the 
terminal the contents of one or more of those files, use the TYPE 
command-. For example, the command 

.TYPE FORM. FOR 

will cause the contents of file FORM. FOR to be typed at the 
terminal . 

If the file you want to list is a long one and you don’t want 
to wait while it prints at the terminal, you may have it printed on 
the high speed line printer instead. To list the contents of 
FORM. FOR on the high speed printer, enter 

•PRINT FORM. FOR 

If you want more than one copy of a file printed, you may use a 
special ’’switch" for multiple copies. 

.PRINT FORM. F0R/C0PIES:3 

will cause 3 copies of file FORM. FOR to be printed. Line printer 
output is dispatched every half hour or so, and may be picked up in 
the bins in the user area on the first floor of Machinery Hall. 


The DELETE Command 

Once you are through using a file it is a good idea to delete 
it. You may also want to delete the backup files created by SOS, or 
any other backup or auxiliary files which may have been created. To 

delete a file type DELETE (or DEL) followed by the name of the file 

to be deleted. To delete the file FORM . QOR for example, type 

.DELETE FORM. QOR 

If you want to delete more than one file, list the names of the 
files to be deleted, separated by commas, after the DELETE command. 

.DELETE FORM .FOR , FORM. QOR 

for example, will delete the two files FORM. FOR and FORM. QOR. Be 

sure not to delete any files which you may wish to use in the 

future . 


The EXECUTE Command 

The programs which you write in FORTRAN, COBOL or any other 
higher level language are known as source programs. They are 
written in a language which is understandable to you, but which must 
be translated for the computer into another form called machine 
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language. Machine language consists of a series of 0's and 1’s and 
is the only language which the computer can understand and execute. 
The process of translating from a higher level language to machi*-#- 
language is known as compilation. 

The compiled version of a program is called a relocatable 
binary program. It is written out to disk as a file with the same 
name as the source file and with the extension REL. Before the 
instructions in the program can be executed, the relocatable binary 
version must be loaded into the computer's core memory. The process 
of bringing a REL file from disk into core is called loading the 
program. Only after loading is complete can execution begin. 

The compile, load and execute sequence described above can be 
initiated in many ways. The easiest way is with the EXECUTE 
command. If you type 

.EXECUTE MYPROG. FOR 

for example, fir3t the FORTRAN compiler will be called to compile 
the source version of MYPROG. FOR and to create a relocatable binary 
file named MYPROG. REL. After compilation is completed, the file 
MYPROG. REL will be loaded into core and execution will begin. Note; 
that in this case the FORTRAN compiler is called because of the 
extension FOR; the extension CBL would cause the COBOL compiler to! 
be used , etc . 

If all is successful, you will get the results you expected 
from your program. If an error occurs, either at compile time or 
during execution, you will have to analyse your program to see what 
is wrong, and use SOS to edit it to correct any errors you found. 
Then after correcting any errors, issue the EXECUTE command again to 
compile, load and execute the corrected version of your program. 
This process of run, analyse, edit, run, analyse, edit, run... is 
called debugging. 

Once your program is correct, you may want to run it several 
times on different sets of data. If so, there is no need to 
recompile your program each time it is to be run. All you need to 
do is load the program into core and begin execution. You may still 
use the EXECUTE command to do this, because the EXECUTE command 
always checks to see if a REL file of the same name as the file 
being processed already exists. If it does not find an appropriate 
REL file, it compiles the source file it is given. If it does find 
a REL file, and the REL file is newer than the source file, it 
assumes that the REL file was produced from the given source file by 
a previous compilation step. Therefore it does not try to recompile 
but simply uses the REL file which it found and continues with the 
load and execute steps. 

There are other commands similar to EXECUTE which may be used 
when you only want to compile a program, or only load a program. 
These commands are discussed in detail in CCIS Memo SI28, "Compilers 
and Compile Class Commands." 
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The SET TIME Command 

When you are first learning to program, one of the easiest 
mistakes to make is to write a non- terminating or infinite loop. 
This is a serious problem since such a loop can quickly use up all 
T> f your account. To prevent a loop from executing indefinitely, you 
may set a time limit for execution with the SET TIME command. If 
you type 

.SET TIME 5 

immediately before the EXECUTE command to run a program, then 
program execution will be stopped as soon as 5 seconds of CPU time 
have been used. Since most small programs take a second or less to 
run, if your program runs for 5 seconds it may be an indication that 
the program contains an improperly specified loop. Of course for 
large programs, larger time limits should be used. Also, be sure to 
reset the time limit each time before you execute your program. 


The R Command 

Many system programs do not have a specific command associated 
with them. To run these programs, the R command is used followed by 
the name of the system program to be run. 

.R QUOLST 

for example will run the system program QUOLST. Many of the 
programs which may be run using the R command are documented in CCIS 
Memo UA29, "DECsystem- 1 0 Utilities.” 


The INDEX Command 

The INDEX command allows you to query the system to discover 
what programs and packages are available on the 370 and on the DEC- 
10. To use the INDEX command, enter 

. INDEX 

You will then be asked whether or not you want instructions. 
Respond either yes or no. If you request instructions, they will 
print followed by an s prompt. if no instructions are requested 
only the * will print. At that point you may begin your request for 
information. You should enter either the name of the particular 
computer program you are interested in, or the name of a subject you 
would like information about. The entry STOP in response to the * 
will return you to the monitor. See CCIS Memo GI26, "Index: A Guide 
to SU Computer Systems," for more information on the use of the 
INDEX program. 
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VII I. Miscellaneous Commands and Control Characters 
Control C 


The control C character is typed by holding down the key markec^ 
CTRL while at the same time typing the letter C. Control C (*C) is 
used to interrupt the program that is currently running and return 
to the monitor. if the program which is running is waiting for 
input, it can be stopped with one control C. Otherwise two control 
C's are needed to stop program execution. Once you have typed the 
one or two ''C's and are back at monitor level you may use any system 
commands you wish. You may want to use control C if you see that 
your program is producing meaningless results. or if you suspect that 
your program may be in an infinite loop. 

Control U 


Control U ("U), which is formed by simultaneously pressing the 
control key and the letter U, is used when you have mistyped a line 
and would like to start that line all over again. It causes the 
deletion of the entire line currently being entered, issues a 
carrier return and line-feed and allows you to start typing -the line 
over again. This is particularly useful when you discovers lot of 
errors in a line before you press return, or when you start to issue 
one command and decide you would rather issue a different command. 

Backspace 


The backspace key is used to correct errors in the line 
currently being entered. If you make a typing error while entering 
a line, simply backspace to the error and retype the line from that 
point. All characters which are backspaced over are erased and will 
be replaced by the new characters which you type. If you backspace 
over more than a few characters you may wish to make the correction 
easier to read by manually rotating the paper feed to move the paper 
up. The new characters will then by typed beneath the old ones 
rather than on top of them. 

SET TTY LC 


Sometimes, when you are preparing text files for example, you 
need to have the computer distinguish between upper and lower case 
alphabetic characters. If you want alphabetic characters to be 
transmitted exactly as entered, you must issue the command 

.SET TTY LC 

This should be done before you enter any text and not after, since 
it effects how the text is stored when it is entered. For example, 
if you want to use SOS to create a text file with both upper and 
lower case characters, you should first enter: 


•SET TTY LC 
.sos filename 


and then 
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IX. How to Log Out if You Have Too Many Files 

Each user of the DEC-10 is assigned two storage quotas. The 
first, known as your logged in quota, places a limit on the amount 
of file storage space which can be used while you are logged in. 
The second, known as your logged out quota, defines the amount of 
disk storage which you may keep when you are not logged in. Because 
many programs generate temporary files, your logged in quota is 
always larger than your logged out quota. 

After you have been using the DEC-10 for a while, you may find 
that you have created more files than you are allowed to keep when 
you are logged out. Usually you discover that you are over your 
logged out quota when you try to log out with K/F and get a message 
like : 

?DSKA Logged out quota 100 exceeded by 15 blocks 

Confirm : 

This means that your files are taking up 15 blocks more than 
you are allowed to use when you are logged out. Since you must be 
below your logged out quota to sign off from the system, you must 
delete enough files to get at or below your quota before you can 
complete th<e logout process. The easiest way to do this is as 
follows: 

1. Type ~C (control C) to end the logout program. 

2. If necessary, give the DIRECT command to discover the 
names and sizes of your files. 

3. Use the DELETE command to delete enough files to get 
below your logged out quota. 

4. Type K/F again to try to logout. If you have deleted 

enough files, the logout will be successful. If not, 
go back to Step 1. ; 

Often you will be over your logged out quota because you have 
generated a lot of temporary and/or backup files which you really 
don't need. For example, if you have been using SOS you will 
probably have generated some files with extensions starting with Q. 
Similarly, if you have been executing several programs, you may have 
generated some .REL files. These are generally the files you should 
attempt to delete first, since REL files can always be re-created 
from the source files and since the SOS backup files are usually not 
needed . 

If you know that you want to get rid of all files with a 
certain extension, or all files with a certain name whatever their 
extension, you can use a shorthand technique for indicating which 
files to delete. This is done by using the * as a "wild card" as 
follows : 
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.DELETE * . REL 

This will delete all files with the extension REL. Similarly, 
.DELETE TEST.* 

will delete all files with the name TEST, whatever their extension. 
The * wild card instruction is very powerful and of course should be 
used with care. 


X. Where To Go From Here 

The information covered in this memo Should provide you with 
the basic tools you need to begin work with the DEC-10. In 
addition, it should provide the basic vocabulary you need to read 
and understand other DEC-10 documentation. The next memo you should 
read after you have mastered the information here is CCIS Memo SI27, 
"DECsystem- 1 0 Reference Sheets." Also, you should check the INDEX 
program and CCIS Memo GI4, "Current Publications", for documentation 
which may help you with any special problems you are having. If you 
need more help than is available in the documentation, check with 
the AID Staff, Room 116 Machinery Hall. 
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1 . Introduction 


The Syracuse University Computing Center operates a Digital 
Equipment Corporation DECsystem- 1 0 Computer System to complement 
and increase the computational resources of Syracuse University. 

The DECsystem- 1 0 Computer System is currently performing 
both general-purpose conversational time-sharing, and multi- 
programming batch processing. The time-sharing user can develop 
a program at a terminal, debug the program interactively, and 
execute the program with conventional or interactive input and 
output. In most cases, this mode of operation significantly 
reduces the time required to write a program and obtain useful 
results. The batch-processing user can submit a job to the 
system via cards or from a terminal, to be run as soon as 
possible or at a later time. 


2 . System Availability 

a. Hours of Operation 

See Posted Hours in Aid Office, Room 116, Machinery Hall, 

x3424. 

b. Location and Terminal Accessibility 

The DECsystem-10 is located in the first floor machine room 
of Machinery Hall. Both the "User Terminal Room", housing 
several terminals, and the "Dispatch Room", for receiving 
printed output, are also located on the first floor of 
Machinery Hall. Cards and tapes should be submitted to the 
Dispatcher in the Dispatch Room. 

At the present time almost all terminals at Syracuse 

University (DECwri ters , ADDS terminals but not IBM 3270 
terminals) can communicate with the DECsystem-10. 

c. Account Validation 

In order to use the DECsystem-10, a validated project 
number, programmer number, and password must be stored on 
the systems disk. The procedure to be followed is: 

1) Get an SUCC account number from the Assistant Business 

Manager, Room 122. She will give the user a copy of 

this number on a signed form. 

2) The information on this form will be stored in the 

system within 24 hours, after which time the user can 
access the system. 
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3 * System Capabilities 
a. Hardware 

The DECsystem-10 Model 1090 computer has the following 
hardware: 

1 KL10B Central Processing Unit 

384K Core Memory (K=1024 words) 

7 Disk drives 

^ Magnetic Tape Drives 

(Shared with IBM/370, 6250/1600 bytes/inch) 

2 Magnetic Tape Drives (800bytes/inch) 

3 DECtape Drives 

1 High Speed Line Printer 

1 Car d Reader 


Notes : 

1) The KL10B processor is "microprogrammed " . That is, many of the 
system's machine language instructions actually consist of several 
micro instructions, allowing more flexibility than a non- 
microprogrammed processor has. The processor has a 2048 word 

cache" memory, more aptly described as fast memory. This memory 
can be used to read four instructions, at one time, from core memory 
so that for three out of four instructions, the processor does not 
have to wait for the next instruction to be retrieved from core. 

2) Although we currently have 384K words of core memory, this is to 
be expanded to 512K sometime within the next year. At that time, we 
will have "Four-way interleaving", that is, the core will be divided 
into four 128K segments. The processor can then read one word of 
information from each segment (for a total of four at one time) into 
Cache memory, speeding up the processing. 

3) One disk drive is reserved for system storage space - for 
languages, _ utility programs, libraries and information and 
documentation files. Two disk drives are available for system 
programmer's and user's private, mountable disk packs. The four 
remaining disk drives are grouped together as one unit named DSKA . 
lhis is where users have their storage space. Initially, users are 
given a 50 block storage quota although they can use up to 1000 
blocks while signed on to the system. 

A block contains 640 characters (letters, digits and special 


!L nnn n M iC | tai ? e ‘ D! " 0Vldes a larger storage capacity, approaching 
2 (JO , 000 blocks, depending on the tape's recording density. This can 
be used to archive (store) old programs and data, to save 
imrequently used information between uses and to provide a backup 
or current disk storage. Magnetic tape also provides the only way 
of passing information from the DECsystem-10 to the IBM/370 (the 
opposite route can be accomplished by both magnetic tape and punched 

C 3 r Q S / • 
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The primary densities available are 6250 bytes/inch and 1600 
bpi. At the moment, there are also 2 800 bpi tape drives available 
but these are expected to be removed within the next year. Any new 
tape should be written at one of the 2 higher densities. 

5) DECtape is a special format of magnetic tape. It is designed to 
provide the storage ability (archiving, backup, etc.) of regular 
magnetic tape, while allowing simple disk-like access to the 
information. The capacity, however, is much smaller than regular 
magnetic tape. Each DECtape can hold a maximum of 574 blocks of 
information . 

6) There are nearly 75 terminals in various locations across 
campus. Each of these terminals is linked to a PDP-11 computer 
which controls the communication and links the terminals with either 
the DECsystem- 1 0 or the IBM/370. 


b. Software 

The DECsystem-10 has one assembly language processor (MACR0- 
10) and eleven primary higher-level language Drocessors 
( FORTRAN-1 0 , BASIC, ALGOL, LISP, SAIL, FLECS, SN0B0L , 
PASCAL, FASB0L, BLISS, and COBOL). All of these processors 
except LISP are reentrant, thus conserving memory space and 
time , 

A number of utility programs exist which considerably ease 
the construction, debugging, modification, and execution of 
programs. The following is a list of some _commonly used 
system programs (CUSPS) and libraries. 

BACKUP - This program can perform disk to tape and tape to 
disk file transfers. It simplifies the use of magnetic 
tape. BACKUP has four kinds of commands: tape positioning, 
status setting, action and runtime commands. 

BASIC PROGRAM LIBRARY - This library includes a variety of 
useful and interesting programs and games for the user of 
the BASIC programming language. 

CHANGE - CHANGE converts data files from one character set 
to another. This conversion is often required when moving 
data or programs from one computer to another, e. g. between 
S.U.'s DEC-10 and IBM/370. It is most often used to write 
an IBM-style data-set onto a magnetic tape from a DEC-10 
type file, or the reverse. 

CREF - This program produces a cross reference listing of a 
program. This listing consists of a list of variable names, 
labels, etc and indications of each location in the program 
where the names were used. 
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CSORT - The CSORT program sorts the records (lines) of a 
file so that a particular segment (called the key) of the 
lines is in alphanumeric order. This order is defined by 
the ASCII collating sequence. The sequence can be used in 
the standard order (ascending) or the reverse (descending). 

DDT - The "Dynamic Debugging Technique" is a program for 
getting the bugs out of compiled programs. DDT allows 
"interactive execution", that is, the running of a program 
step by step, pausing to input or output values in order to 
isolate any problems the program may have. Also available 
are simplified versions of DDT designed for FORTRAN programs 
(FORDDT), for COBOL programs (COBDDT) and for ALGOL programs 
( ALGDDT ) . 

D ECUS LIBRARY - The DECUS Library is a set of ten tapes 
containing many general (and specific) interest programs. 
Included are tutorials, games, application programs, 
utilities, languages,... These programs are in many 
different languages. Except for a few commonly used 
programs, users are responsible for copying the desired 
programs into their own storage areas for use. 

DIRECTORY _ The DIRECTORY program allows the user to get a 
listing of the names of the files stored in the user's own 
storage area, or in other areas (if allowed access to those 
files). The listing includes other information in addition 
to filenames, e.g. creation dates, size of the files, etc. 


DUMP - The DUMP program is used to get readable output of 
the (binary) contents of specified memory locations. The 
stored information can be converted into assembly language 
equivalent, octal digits or ASCII characters (among other 
forms), generally giving an idea of what is stored. 

DYNAMO - "Dynamic Modelling"; a compiler developed at MIT 
for describing and running continuous Models. DYNAMO is a 
programming language which allows a shorthand notation to 
represent differential equations. These coded equations can 
then be solved by the computer. 


FILCOM - The FILCOM program is designed to compare two 
versions of a file and to list any differences encountered 
(or just a note about whether or not there are differences, 
if you prefer). FILCOM can compare ASCII or binary files. 
The output file from FILCOM will contain a listing of lines 
that differ in the two files. 
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FILEX - FILEX is a file transfer program which is capable of 
doing certain conversions of format. It's most significant 
uses are copying an entire DECtape to another DECtape and 
converting .SAV type core image files to .EXE type files 
(the new format). 

GLOB - This program reads one or more binary program files 
(compiled programs) and produces an alphabetical cross 
reference listing of all the global symbols used. 


GRIPE - A "Suggestion and Complaint" box. GRIPE allows any 
user to type comments into s special storage area which 
staff members periodically check. 


HELP - HELP is a program which types out information about 
many DEC-10 programs and commands. The command HELP gives a 
description of the HELP program. "HELP *" returns a list of 
the items for which there is information, i.e. things which 
have a help file. HELP followed by a name gives information 
about the named item, if available. 


INDEX - The INDEX program is an on line documentation 
system. You can get a listing of the available Software at 
S.U.(on both computers) for a given topic, or discover if a 
particular program is available. INDEX also points towards 
further documentation and gives notes on where to get help 
and how much help to expect. 


ISAM - This program is designed for the maintenance of 
indexed sequential files. With this program, you can build 
an ISAM file from a sequential file, do the reverse, or 
update an ISAM file's storage parameters. 


LIBARY - This program is a text editor for creating and 
correcting COBOL library files. A COBOL library file is 
stored in a special format (thus the need for a special 
editor) and is used by the COPY verb in COBOL to simplify 
writing programs. 


LINK- 1 0 - This program is the default loading program. 

Consult the LINK-10 Manual in the AID Office. 


MAKLIB - The MAKLIB program is used to update binary library 
files. It is possible to create files which contain binary 
"modules", i.e. program units stored so that they are 
accessible to programs you may write. These modules can be 
combined into library files for use by several programs. 
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PIP - The "Peripheral Interchange Program" transfers files 
between devices: disk to terminal, DECtape to line printer, 
etc. It is also capable of doing some processing of the 
information, renaming files and deleting files. 


QUOLST - QUOLST is a simple program which returns the user's 
storage allocation and quota information. 


RUNOFF - A text formatter, RUNOFF does all of the things 
involved in writing papers (justification, page numbering, 
footnotes, etc.). To use RUNOFF, create a text file 
containing the information to be used. Then insert the 
appropriate RUNOFF commands into the text. The RUNOFF 
program will justify the text, split into pages and take 
care of other details desired. 


SETSRC - SETSRC is a program which allows you to find out 
and/or alter your "search list". The computer uses the 
search list whenever you specify a file on disk. Since 
there are actually several disks in the System, we need the 
search list to specify the order in which the disks should 
be searched for the file. 

SOS - An extremely powerful and concise text-editing program 
with approximately 50 commands for inserting, deleting, 
appending, searching and displaying text. Editing is 
performed either line by line or by character within a line. 
In addition to conventional editing operations, it also 
provides interactive search, match and substitution 
operations . 


STATPACK - STATPACK is an interactive system for performing 
a variety of statistics. The STATPACK commands deal with 
one form or another of statistical analysis. It is fairly 
simple to use, although its manual is fairly large. 

SYSTAT - The System Status program returns a wide variety of 
information about the who , what, where, how much, etc. of 
system use. The command returns which users are currently 
logged in, what programs are being used, what devices are 
being used, and much more. 

TECO - An extremely powerful and concise text-editing 
language with more than thirty commands for inserting, 
deleting, appending, searching and displaying text. Editing 
is performed on a character line, or a variable character 
string basis. In addition to conventional editing 
operations, it also provides interactive string search, 
match and substitution operations. 
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A complete list of the software available on both the 
DECsystem-10 and the IBM/370 is given in the INDEX system 
which is an on-line documentation program. 


4 . System Advantages 


The DECsystem-10 hardware and software capabilities provide 
a computing system that has particularly significant strengths 
and advantages in the following areas: 

Interactive usage - The monitor system has been designed to 
provide rapid response to a large number of simultaneous users, 
each of whom can be interactively creating, editing, debugging, 
or executing a program. This interactive mode of use results in 
a significant reduction in the time required to obtain useful 
results from the program. Because the usual waiting for batch 
processing output is eliminated, the user can concentrate his 
time on one project, rather than "multi-program" his time among 
a number of projects. Consequently human as well as computer 
output is increased. 

These advantages of interactive usage are independent of the 
implementation language (e.g. FORTRAN, LISP, COBOL, or MACRO-10) 
or the ultimate mode of use (batch or time-sharing) and 
consequently benefit all users. 

Instruction repertoire - The 398-instruction repertoire of the 
DECsystem-10 simplifies assembly coding and can reduce the size 
of higher-level language programs. 

Word length - The word size of the DECsystem-10 is 36 bits. 
This permits single precision arithmetic to be accurate to 7 
significant digits, while double precision is accurate to 18 
significant digits. The DECsystem-10 represents alphanumeric 
characters in the 7-bit ASCII cede (in contrast to the IBM/370 
which uses the 8-bit EBCDIC code) . Thus one word in the 
DECsystem-10 can store 5 characters. 

5. Memos and Short Courses 


a. Memos - There are several CCIS memos documenting various 
programs and systems of the DECsystem-10. The memos 
available are listed in CCIS memo GI4 (in the AID office); 
most are available free of charge in the AID office. The 
first thing needed by most users is the "Introduction to the 
DECsystem-10" packet available in Room '122 Machinery Hall 
for $1.25. See Appendix C for a list of CCIS Memos 
pertaining to the DECsystem-10. 

b. Short Courses - Several short courses, in the form of an 
introduction to the facilities and software of the 
DECsystem-10 computer system, have been given in the past 
and will be given in the future with sufficient interest. 
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Other short courses, tailored to particular subjects, will 
be scheduled if sufficient requests are made. 


6 . Pricing Information 

a. See . CCIS Memo OP 1-1 131 titled "SUCC Charges". 

7 . Accounting 


All charges for DECsystem-10 usage will be billed against 
the SUCC account number which covers all SUCC resources (IBM 
370/155, APL, etc.). Those users who are using both computers 
should remember that the total of the charges on both computers 
will be billed against their account number, and compared to 
their budgetary limit. 


Software and Hardware Problem Reporting 


The reporting of system problems that are encountered should 
be done in the AID Office, Room 116 Machinery Hall (x3424), or 
if the AID Office is closed, report to the Dispatcher in the 
Dispatch Room on the first floor of Machinery Hall ext. 3-3245. 

Be sure to bring terminal output which clearly and concisely 
demonstrates the problem and the environment in which it took 
place, as this greatly helps in analyzing the problem. 

Another important method for reporting both software and 
hardware problems is to use an APL program named TROUBLE. You 
must, of course, know how to use APL to use TROUBLE. After 
entering the command )L0AD 1 TROUBLE (when signed on to APL), 
you will be asked to describe your problem. This information is 
regularly read by SUCC staff and greatly helps in the 
maintenance of the system. 
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APPENDIX A 


DECsystem- 1 0 CCIS Memos 

GI23 Introduction to Timesharing on the DECsystem-10 

GI24 DECsystem-10 Availabilities & Capabilities 

GI25 DECsystem-10 Glossary 

GI26 Index: A Guide to S.U. Computer Systems 
GI27 Software Index 

S1 1 9 DECsystem-10 Beginner's Guide to Multiprogramming Batch 

51 24 Creating Disk Files Using the DECsystem-10 Card Reader 

51 25 DECtape on the SUCC DECsystem-10 

51 26 DEC-10 Switch Lists 

5127 DEC-10 Reference Sheets 

51 28 DEC-10 Compilers & Compile Class Commands 

TX1 TECO-Text Editor and Corrector 

TX2 SOS-A Line Oriented Text Editor Used on the DECsystem-10 

TX3 RUNOFF-Text Formatting Programs 

TX4 Summary of RUNOFF Commands 

UA28 DDT - Debugging on the DEC-10 

UA29 Introduction to the DECsystem-10 Utilities 

UA 32 PRINT10 Utility for Printing DEC-10 Documents 

on the IBM/370 

LX3 Summary of COBOL on the DEC-10 

LX4 LISP Cross' Reference 

LF 1 8 FLECS: User's Manual 

LF19 Comparison of FORTRAN Compilers at S.U. 

LF21 DECsystem-10 FORTRAN Switches 

SM25 STATPACK - Interactive Statistical Package for DECsystem- 1 
Version 4 

0P1 SUCC Charges 




PUBLIC TERMINALS AS OF 1/9/79 


Id_ 

TYPE 

LOCATION 

ID 

TYPE 

LOCATION 


7'i 7V 

LA 3 7 

706 

BIOLOGICAL RSRCH . BLDG . 

050 

LA31 

114 

LINK HALL 


0 b- A 

I A 31 

209 

BOWNE HALL 

051 

LA31 

114 

LINK HALL 



LA 31 

209 

BOWNE HALL 

052 

LA 3.1 

1 14 

LINK HALL 


083 

LA31 

209 

BOWNE HALL 

053 

LA31 

114 

LINK HALL 


0 8 9 

LA 3 7 

209 

BOWNE HALL 

049 

LA31 

304 

LINK HALL 


u 7 0 

LA31 

CTL 1 

BREWSTER-BOLAND DORMS 

04/4 

LA31 

304 

LINK HALL 


0 o 

LA31 

CTL 1 

BREWSTER-BOLAND DORMS 

04B 

LA31 

304 

LINK HALL 


• S F 

LA 3 7 

218 

CARNEGIE ( MATHEMATICS ) 

04(7 

LA31 

304 

LINK HALL 


oso 

LA 3 7 

218 

CARNEGIE ( MATHEMATICS ) 

090 

LA31 

116 

MACHINERY HALL-AID 

OFF. 

07 6 

LA 3 7 

218 

CARNEGIE (MATHEMATICS) 

367 

3277 

116 

MACHINERY HALL-AID 

OFF. 

07 B 

LA31 

218 

CARNEGIE ( MATHEMATICS ) 

042 

LA31 

119 

MACHINERY HALL 


083 

LA31 

218 

CARNEGIE (MATHEMATICS) 

043 

LA31 

119 

MACHINERY HALL 


08 4 

LA31 

218 

CARNEGIE (MATHEMATICS) 

0/40 

LA31 

119 

MACHINERY HALL 


0.4 2 

LA31 

218 

CARNEGIE (MATHEMATICS) 

OAB 

A980 

119 

MACHINERY HALL 


0.4 3 

LA31 

218 

CARNEGIE (MATHEMATICS) 

0/4(7 

.49 8 0 

119 

MACHINERY HALL 


075 

LA31 

100 

DAY HALL 

0 AD 

/49 8 Q 

119 

MACHINERY HALL 


079 

LA 3 7 

212 

HEROY GEOLOGY BUILDING 

363 

3277 

119 

MACHINERY HALL 


01 A 

LA31 

212 

HEROY GEOLOGY BUILDING 

065 

LA31 

1XX 

MAXWELL HALL 


0 44 

LA31 

116 

HINDS HALL 

0 6 B 

LA31 

1XX 

MAXWELL HALL 


045 

LA31 

116 

HINDS HALL 

062 

LA31 

RXX 

MAXWELL HALL 


046 

LA31 

076 

HINDS HALL 

055 

LA31 

B107 

PHYSICS BUILDING 


047 

LA31 

315 

HINDS HALL 

056 

LA31 

B107 

PHYSICS BUILDING 


048 

LA31 

315 

HINDS HALL 

057 

LA31 

Bl 0 7 

PHYSICS BUILDING 


0 BA 

LA31 

B001 

HUNTINGTON HALL 

058 

A/437 

B107 

PHYSICS BUILDING 


069 

LA31 

315 

HUNTINGTON HALL 

059 

A/5 3 7 

Bl 0 7 

PHYSICS BUILDING 


061 

LA31 

239 

H.B.C. HALL 

064 

A/437 

FA 1 

SHAW DORM (MAIN OFFICE) 

081 

LA31 

239 

H.B.C. HALL 

067 

A/437 

304 

SIMS HALL 


0 8/4 

LA31 

204 

LAWRINSON DORM 

068 

A/437 

304 

SIMS HALL 


08 B 

LA31 

204 

LAWRINSON DORM 

05(7 

A/437 

210/4 

SLOCUM HALL 


054 

LA31 

B105 

LINK HALL 

05 D 

A/437 

210/5 

SLOCUM HALL 


04 D 

LA31 

114 

LINK HALL 

05 E 

A/437 

210A 

SLOCUM HALL 


04 E 

LA31 

114 

LINK HALL 

06 F 

A/437 

210/J 

SLOCUM HALL 


04 F 

LA31 

114 

LINK HALL 

066 

A/437 

508 

UNIVERSITY PL. (POL 

SCI) 


TYPE 

QTY 

TERMINAL DESCRIPTION 

/59 8 0 

3 

ADDS 980 CRT 

WITH FULL ASCII SET 

A/537 

61 

DECWRITER II 

WITH APL/ ASCII SET 

3277 

2 

IBM 3277 CRT 

WITH EBCDIC SET 

TOTAL 

66 

FOR 3 TYPE(S) 

OF TERMINAL(S) 



TIME SCHEDUi E 

OF BUILDINGS HOUSING TERMINALS 


BUILD ING 

BOWNE 

CARNEGIE 

H . B . C . 

HEROY 

HINDS 

HUNTINGTON 

LINK 

MACHINERY 

MAXWELL 

PHYSICS* 

SIMS 

SLOCUM 

^closed Friday 


MONDAY-FRIDAY 

7: 30AM-1 1 : 00PM 
7 : 20AM- 1 1 : 00PM 
6: 1 0AM- 1 1 : 10PM 
6 : 00AM- 1 1 : 20PM 
6 : 20AM- 1 1 : 00PM 
6 : 00AM-10: 30PM 
7: 35AM-10: 45PM 
8: OOAM-MIDNIGHT 
6:00AM- 5:00PM 
7 : 30AM-10: 30PM 
7: 35AM-10: 45PM 
6 : 30AM-1 0: 45PM 
at 5:00PM 


SATURDAY 


8 : 00AM- 1 : 00PM 
8: 00AM-5: 00PM 
6 : 30AM-5: 00PM 
6: 30AM-5: 00PM 
6 : 30AM-5 : 00PM 
6: 35AM-5 : 00PM 
6 : 30AM-5: 00PM 
8: 00AM-7: 00PM 
6: 35AM-5: 00PM 
CLOSED 

6 : 30AM-5 : 00PM 
6 : 30AM-5 :00PM 


SUNDAY 

CLOSED 

CLOSED 

CLOSED 

CLOSED 

CLOSED 

CLOSED 

CLOSED 

9: OOAM-MIDNIGHT 
CLOSED 
CLOSED 
CLOSED 
CLOSED 


All buildings are locked at noon on Saturday during home football 
games. Also, you will sometimes find some terminal rooms locked. 
Instructions for obtaining keys are usually posted. 



3ADEMIC COMPUTING CKi 
MACHINERY H/ 


CQ 


, 

o^rotrun 

on 

in 

3 to 

rH S* 

r— 


in 

r> ^ 


r— 

^r 

iH a 


ON 

■rr 

00 X 

Cn r- OJ CM 

CC 

oj 

CO <0 

O 

O'. 

CM 

w 

moofooo 

OO 

on 

02 X 

on 

m 

on 


♦ nr 
o s: 

in o oj oj 

in 

CO 

OJ 

CM 

CM 

on 

o 

OOJOO 

CM 

o 

OJ 

CM 

CM 

o 

X c 

CM «- t- r- 

T“ 

t— 

r— 

s— 

*— 


•r-i 










‘0 

X 






c 

0 

x 



x 


rH O 

CO 

0 



0 


a) ;s 

W 

x 

>» 

>> 

x 

0 

aa 4 a 


0 

rH 

rH 

0 

E 

X to 

c 

X 

rH 

rH 

4 a 

CO 

0 CO 

0 

<0 

0 

0 

0 

z 

S £*2 

> 

a 

US 

us 

Cl 




to 



W 


• • 

• 

•H 

• 

• 

•|H 


Lu 2e 

a. 

Cl 

US 

us 

0 


in 

in. 

r- rr 

VO 

0- 

r--7 r- 

XT 

=T 

=? 

CM 

cnsr *- 

— • 

0- 

0 cm O 

CM 

OJ 

CM 

on 

GO C\1 r- 

in 

vO 

co m co 

^r 

^r 

on 

■=r 

rocosr 

CM 

CM 

CM =T CM 

co 

on 


on 

=r 

«- xt cm 

CM 

co 

O 

COO CO 

vO 

vO 

0 

CM 

CM O CM 

CM 

r— 

in 

*- O «“ 



**“ 

T “ 

CM CM CM 

r— 

r* 

CM 

CM CM CM 

r— 

r- 




x 









w 









3 









X 


0 

4a C 4a 



x 



c 


O 

x 0 x 



0 

X 

>» C 

0 


•H 

0 4 a 0 



X 

0 

0 -H 

X 



> c > 



0 

CL 

rH C rH 

0 



to s_ to 

0 

to 

4 a 

O 

£ £ rH 

CO 


O 

•H O *H 

4a 

4 a 

CO 

O 

<TJ X=C 03 

3 



0 X 0 

CO 

CO 

a 

32 

xoz 

a 


£ 

aa h cq 

to 





•H 


Q 

Cl 

•iH 

• 

• * « 

• 


CO 

• « * 

w 

►H 

Q 

3: 

a> tsj 0 

*'3 


2: 

52 *n> 2! 

< 

<5 


O 



bO 




0 

T3 



c 




0 

g 



•H 




c. 

0 



4a 



u 

3 




3 

0 


0 

0 

0 


x 

CL 

0 

0 

4 a bO 

0 

s- 


0 

E 

•iH 

0 

c c 


3 


4 a X 

O 

4a 

1 — 1 

0 *H 

4 a 

rH 


0 O 

O 

•H 

• 3 

0 *a 

s- 

•H 

0 

X X X 4^ 


rH 

0 T3 

0 

0 

0 

0 

O000 

«■ 

•H 

4 a O' 

bO O 

x: 

<H4 

•H 

4 J to a l 

W 

O 

0 x: 

C 0 

0 


rH 

0000 

0 

0 

•H 0 

•H - 0 


1 — ( 

Q. 

0 C CL 

•H 

(x-> 

rH 0 

ja 0 4 a 

0 

0 

Q. 

X 0 O O 

4 a 



3 -P 0 


£ 

3 

■rl 21 E*"* 

•H 

x: 

rH 0 

Q. 0 rH 

$- 

•rH 

0 

0 on 0 

rH 

0 

0 0 

E ^ CL 

0 

E 


to *~ 

•H 

£ 

C U 

O O E 


L. 

bO 

4 a c s 1 

O 

3 

•H 3 

O 00 


0 

c 

0 

c O 0 £ 

0 0 

Cl 

S O 

CL 4 a 

bO 

4 a 

•rH 

0 

tO 0 *H X 0 

l- 

>> 

S~ O 

bD 

C 


-P 

x 

c 4 a 4 a to 4 a 

0 

0 

0 

c •* - 

•H 

bO 

0 

«=c 

O 0 0 >, 10 

rH 3 

Ui 

4 a 4 a 

•H 0 0 

S- 

c 

0 

•H H L CO >, 

0 *o 


S~ 

0 O E 

0 

•H 

3 

4 a 10 0 0 

0 i~ 

0 

0 O 

0 E L. 

4 a 

-P 

cr 

0 to cl 2 ? 0 

•H CO 

•iH 

ih x: 

x: 0 0 

0 

L. 

0 

L < O CQ W 

0 E 

rH 

rH CO 

0 E 

•rH 

O 

c. 

0 HQ 

>> 

X3 

X) 

s~ 

bO 

CL 


CL 

JZ 

3 

3 

3 

0 

0 


O 

CL, 

Q- 

a- 

a. 

£X 

or. 










0 







0 

rH 

0 


u 




0 in 

0 

X3 


0 m 




th in 

3 

O 

bQ 

b04a un 




U r— 

C 

•O 

£ 

c 0 <- 




0 N. 

0 


•H 

•H 0 \ 




c. 0 

E 

x: 

L- 

E s- 0 




XI c- 


0 

0 

E H C — 




•h on 0 

0 

4 a 

0 

Co Ci mo 

£ 



xi t- 

O 

0 

£ 

U T- 

0 

E 


E 1 

£ 

n 

•H 

b04a & 1 

•H 

O 


E 0 E 

0 


b.0 

O £ 0 E 

L. 

O 


0 4 a 0 

L. 

bO 

C 

t, 0 4 a 0 

0 

OS 


l w a 

0 

£ 

UJ 

O- 4 a to 4 a 




bO >» 0 

Cm 

•H 


0 >> 0 

n 

rH 


O CO >> 

0 

4 a 

0 

to H 00 >1 

•rH 

0 


£ 0 

U 

4J 

,E 

E 0 0 


£ 


a-soj 


•rH 

0 

0 0 S O 


•H 

0 

QUO. 

tti 

E 

4 a 

4 a < CQ LU 

0 

E 

J— 

LH Q< 

£ 

X> 

0 

0 HQ 

CL 

tm 

3 

0 

•H 

3 

>» 

>» 

0 

0 

O 

0 

0 

CO 

CO 

CO 

H 

H 

H 

r> 

=> 


W 

H 

0 

£ 

•M 


0 

X 


>» 

CO 

H 

cl 

w 


T3 

O 

0 

T3 

•H 

> 


bO 

£ 

•H 

W 

=> 


• 

O 

in 

vO 

'Ot-srrr 


3) 4 a 

vO 

0 “ 

r— 

«- CTv CM «— 

CM 

CO X 

^ — 

0 - 

in 

co qv sr co 

43- 

UJ 

on 

CM 

CM 

oj co on on 

on 


• 32 






O 2: 


T— 

CM 

CO vO VO CO 

vO 

C 

0 

CM 

(M 

r- O t- «- 


XI £ 

CM 

t— 

T— 

CM CM r- 1 — 

t— 

♦|H : 



X 






0 






3 





0 

X3 

4a 




£ 

£ 

X 




•rH 

0 

0 0 <X 




rH 

2^ 

>Htw 


0 

1 ** 

X 

O 

0 X) 0 

0 

E 

C 

0 

0 

•H T3 4 a 

4 a 

0 

0 

n 

3 

O -H CO 

CO 

as 

1 US 

w 

O' 

CQ CC 





O 

Cl 


• 

• 

• 

• • HH 

t-H 


a. 

X 

-3 

2: CQ < 

< 


CO 

*D X 
l- £ 


0 


4 a 0 0 




0 


£ 0 O 




O 


3 0 0 




•rH 


O CL 




> 


O X 




X X 


0 too- 



>» 

0 O 


0 C < 



X 0 

CO 4a 


•rH 



3 X 

O 


£ DO c 



Q C 

X 0 


0 £ 0 



0 

0 X • 


0 



£ X 

4a -rH 


bQX bO 



O 0 

3 O 


£ O £ 


to 

•H 

a 


•H *H 


X 

X 0 

E 4a 


X -X 


0 

C 0 

0 

0 c 


n to w 


0 

0 «=C 

0 

O 0 

bO 

•H £ -rH 

0 

•rH 

X 

X 

4 a 

£ 

* — t *rH rH 

O 

> 

H 0 

< 

O 0 

•rH 

X rH X 

•H 

X 

3 0 

•H *rH 

4 a 

0 rH 0 

X 

0 

0 X 

E 0 

c 

X -H X 

X, 

CL 

£ 3 

0 0 

3 

0X0 

0 

3 

O O 

-o <c 

O w UJ 


co 

O O 

CO 

0 


Q 



O 

0 


HH 



«=C 

<n 


<C 




rH X 

X O 

o 

X E 
a. a) 
x 
x to 
o >» 

t. « L 

x O 

0 "O X 
0 £ 
fc£) 4-5 0 

c a 

•t-i 0 X 

E CL o 
E 0 X 
0 3 0 
L 10 L 
bD 0 

o l a 
x o o 
cl 

<c 


CM 

X 

m 

l>-0- 

Sf 

=r r- in 

=r 

in 

X 


CM 

CJv 

r — 

» — 

C-C- 

CM 

CM ON 

CM 

XT 

t— 

Ov 

Ov 

CJN 

in 

on 

X X 

XT 

iTO>'- 


CM 

in 

Ov 

CPV 

on 

CM 

T ” 

CM CM 

on 

on on cn 

on 

on 

CM 

on 

on 




< O 








on 

CM 

O O 

X 

X CM O 

X 

CM 

CM 

CM 

on 

O 

CM 

in in 

r— 

r- CM in 

r“ 

0 

CM 

CM 

0 

CM 

T *~ 

CM CM 

r- 

r~ r- CM 

r- 

t — 

T- 

r— 

CM 


X 






X 




0 






0 




3 






3 




X 

0 





X 




£ 

0 £ 



0 


c 



rH 

0 

£ 0 

Xr 

X 

O 


0 


X 

0 

as 

O X 

X. 

X >» 

•H 


as 

>» 

0 

bO 

0 

•n> 0 

0 

0 rH 

X 


0 

X 

bO 

0 

0 

0 

X 

X H >» 

X 


0 

X 

0 

O 

3 

• X 

CO 

CO 0 O 

0 

X 

3 

0 

O 

US 

O' 

*“3 CO 


US -3 


X 

0 

US 

US 




0 

Q 

Cl 

0 




• 

• 

• • 

IH 

IH . . 

X 

X 

• 

• 

• 

*-b 

*"3 

3s > 

<c 

*=> US *”3 

<c 

CO 

*“3 

US 

-3 





0 










Xh 




X 


0 


0 








Cm 




X 


0 


rH X 








0 




bD 


0 

X 

0 0 








X 




3 


O 

c 

X X 








w 




0 


<C 

X 0 

£ E 





£ 





0 

X 

X 



C x 

0 0 





O 



"O 


0 

0 

0 


0 

X 0 

<►* £ 





•H 



£ 


X 

•rH 


c 

O *H 

0 




£ 

X 


X 

0 


0 

O 

X 


0 

0 0 

X 




O 

0 


0 


2S 

0 



X 

X 10 

X, 




•H 

X 


tw 

>» 



Q. 

0 


Q. 

•H C 

- 0 




X 

X 



X 

0 

X) 

0 

X 


0 

Q 

0 X 




0 

0 


0 

rH 

0 

x> 


0 


rH 

0 

E CO 




E 

•H 


X 

3 

•H 

3) 

X 


0 

X > 

0 




X 

DO 


£ 

0 

> 

CO 

O 

0 


H 

0 *H 

X X 




O 

0 


3 

0 

X 


X 

to 

-o 


X X 

x 0 




Xr 

OX 


O 

X* 

0 

TJ 


X 

X 

rH 

£ 0 

O *H 




£ 



0 


0 

£ 

0 

3 

0 

0 

0 X 

X c 


0 


H 

X 


O 

9k 


0 

X 

O 

0 

•rH 

O X 

CL 0 


bO 



0 


0 

0 


c 

O 

CQ 

a 

0 

CO 

0 

X 


rH 

0 

X 


X 

£ 

X 

0 




bO*H 

bC 

O 

0 

"0 

0 

0 

0 

0 

£ 

•H 

0 

g 

X 

c 

X 

£ C 

£ CJ 

E 

X 

0 

X 

X 

X 

> 

0 

X 

X 

0 

X 

•H 

0 

•H *H 

•H O 

0 

X) 

0 

0 

0 

0 

•H 

*U 

0 

X 

bO 

0 

X 

X 

x E 

X 

Z 


•H 

C 

Cl 

X 

X 

3 

c 

0 

£ 

X 

0 

3 

3 T3 

3 O 


0 

X 

0 


0 

£ 

X 

3 

rH 

0 

0 

rH 

Cl 

CL^C 

a. x 

CO 

X 

a. 

O 

as 

a 

0 

0 

a 

0 

X 


»H 

E 

E 

E 

rH 




0 

0 

O 


>. 

3t 

X 


3 

O 

O 

O 

X) 




•H 

•iH 

£ 


0 

0 

<c 


CQ 

x> 

O 

O 

X) 




CQ 

O 

Hi 


us 

2 




SYRACUSE UNIVERSITY COMPUTING CENTER 


INFORMATION SERIES 


[ 

I 


1 

[ 

DOCUMENT 1 


] 

[ 

1 

TITLE 

] 

[ 

GI26-1 21 4 I 


1 

c 

D 

INDEX: 

3 

L 

D 

A Guide to S.U. 

3 

[ 

DATE I 

Computer Systems 

3 

11 

D 

3 

[ 

01/15/79 1 


3 

[ 

e 


3 

L 



3 

[ 

AUTHOR: 

D. Kerr 

3 

[ 



3 

[ 

UPDATE: 

J. Thornton 

3 

[ 



3 


AUDIENCE: 
COMPUTER (S ) 
LEVEL: 
REFERENCES: 

ABSTRACT: 


All Users 

IBM 370/155 & DECsystem-10 
Introductory 

Supercedes GI26-1142, titled as above 
1. CCIS Memo GI27, 'Software Index’ 


This memo describes the use of 
of the INDEX system is to provide an 
computer programs and 
It also points you to 
system is designed 


the INDEX system. The purpose 
easy way to find out what 
packages are available for public use at SUCC. 
documentation for these programs. The INDEX 
so that you may get information either about a 


particular program or package or about a general subject topic 


5 Pages 


$ 0.00 
















INDEX: A GUIDE to S.U. Computer Systems 


INTRODUCTION 


The purpose of 
find out what computer 
public use at SUCC. 
programs. The INDEX 
information either ab 
general subject topic. 


the INDEX s 
pr ograrns 
It also poi 
system is 
out a partic 


ystem is to provide an 
and packages are av a 
nts you to documentatio 
designed so that yo 
ular program or package 


easy way to 
ilable for 
n for these 
u may get 
or about a 


USING THE INDEX SYSTEM 


The INDEX system is available through any DEC-writer or 
terminal on campus. To begin using the INDEX system, turn on 
terminal, and press return. A line should print indicating 
are now in contact with the Syr ac use University Timesharing 
Next, type the word INDEX, and press return. You will then 
whether or not you want instructions. Type either YES or 
press return. If you request instructions, they will 


ADDS 
the 
that you 
System . 
be asked 
NO and 
print , 


followed by an * prompt. If no instructions are requested, only the 
prompt will print. Once the * prompt has printed, you may begin 
your request for information. You should enter either the name of a 

subject about 
response to 
Remember that 
computer . 


specific computer program, or the name of a particular 
which you would like information. The entry STOP, in 
the K prompt, will cause program execution to stop, 
you must press return after each line you type to the 


The following is an example showing 
to request information about STATISTICS, 
computer is underlined. 


how to use the INDEX system 
Information typed by the 


0^2) SU TIMESHARING 10.42. 53 MO N 01/15/79 V1M34 

/index — — — — 

IN DEX 

DO YOU WANT INSTRUCTIONS? NO 
^STATISTICS 


At this point the information 
available at S.U. will be printed. 


about the statistical packages 


INDEX SYSTEM OUTPUT 


^. Four lines of output will be printed 
INDEX entry which matches your request 
beginning of the first line is the 
If the reference is to an APL workspace 
will appear in parentheses after the name 
line of output is a short description 


at your terminal 
for information, 
name of the program or 
or function, either 
The rest 
of the program or 


for each 
At the 
package . 
WS or FN 
of the first 
package . 
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The next two lines contain information on language, machine, 
assistance and support. LANGUAGE defines the programming language 
you need to know in order to use the package or program being 
described. For example, to use the plot program FPLOT, you need to 
know APL, so APL is listed as its language. Most self-contained 
packages will have the package name as the language since no 
knowledge of anything beyond the package itself is required. 

The entry titled MACHINE indicates on which computer a program 
or package is stored. Some programs are on the DEC-10, some on the 
IBM 370/155, and some are on both. 

The purpose of the ASSISTANCE category is to identify the 
department responsible for the program or package, and to give a 
phone number to call for help. Assistance references to the AID 
Office indicate that an entry is the responsibility of the Computing 
Center . 

The SUPPORT category defines the level of assistance you will 
receive from the department responsible for the program or package. 
The INDEX System Support Levels are: 

1. FULL SUCC SUPPORT - maintenance, updating and documentation by 
SUCC. Staff will investigate problems, if necessary. Also, AID 
Office assistance and Senior Staff referral. 

2. AID & STAFF CONSULTATION - but no maintenance by SUCC (for any 
software, updates that are provided to SUCC will be installed). 

3. SOME CONSULTATION - help is available as time allows, if the 
problem seems fixable and not too difficult. 

^ . ENTRY LEVEL HELP ONLY - AIDs will consult only on the basics of 
getting started . 

5. DOCUMENTATION ONLY - documentation is available for reference in 
the AID Office. 

6. NON-SUCC SUPPORT - the department or person indicated by INDEX 
may be expected to attempt to answer simple questions not answered 
by on-line documentation files. 

The final line of output provides information about 
documentation. That is, it tells you where you can find more 
documentation for this program or package. References may be made 
to manuals, texts, information f-4l.es, CCIS memos, the APL 
Documentation System (ADS), etc. An indication is also given as to 
where to find the documentation (i.e., bookstore, 122 Machinery 
---■"il, 1 1 6 Machinery Hall, etc.). All CCIS memos are available 
either in Room 116 Machinery Hall, (free memos) or in 122 Machinery 
Hall (those for sale) . 
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Gx26 - INDEX: A GUIDE TO S.U. COMPUTER SYSTEMS 


SAMPLE OUTPUT 


Suppose you 
example, to request 
S.U. Your request 


used the . INDEX system as shown in the previous 
info rmation about the statistical packages at 
and the program output would look like this: 


STATISTICS 
APL STATPAK 

LANGUAGE: APL 
ASSISTANCE: AID OFFICE 
DOCUMENTATION: ADS 


A COLLECTION OF APL STATISTICAL FUNCTIONS 
MACHINE: IBM/370 
X3424 SUPPORT.-FULL 


BMD 


LANGUAGE : BMD 
ASSISTANCE : AID OFFICE 
DOCUMENTATION: BMD USER 


STATISTICAL PROGRAMS, INCLUDING ANOVA 
MACHINE: IBM/370 

X3424 SUPPORT : AID & STAFF CONSULTATION 

PACKET (AVAILABLE IN ROOM 122 MH) 


IMSL 

LANGUAGE 


FOR tram MATHEMATICAL, STATISTICAL SUBROUTINES 

r Uni KAN MACHINF*TRM/^7f) 

ASSISTANCE: AID OFFICE X3424 SUPPORT:FULL SUCC SUPPORT 
DOCUMENTATION: CCIS MEMO SM20, IMSL MANUAL (AID OFFICE) 

SPS LANGUAGE • SPSS STATISTICAL PACKAGE FOR THE SOCIAL SCIENCES 

ASSISTANC E^ A ID OFFICE X3424 sSpPoSf i SPsScC SUPPOET 
DOCUMENTAHON:SPSS MANUAL (BOOKSTORE), SPSS USER'S PACKET 

c TfiTPilI( r 

LANGUAGE: STATPAK STATISTICAL ^YSIS 

ASSISTANCE : AID OFFICE X3424 SUPPORT-FULL SUCC SUPPORT 
DOCUMENTATION: CCIS MEMO SM25 C SUPP0Ri 


Wh e n 
topic 


the -prompt reappears, you may reouest 
or enter SiOP to exit from the program. 


information on 


another 


COMMANDS 


Ollu 

are 


There are several commands which mav 

p ’ jt pr °™ the INDEX system. These commands 
as follows: 


be 

and 


used to 
their 


alter the 
f unctions 


SHORT 


LONG 

LIMIT : n 


Sets the output format to short form 
program name, language, and machine are 
each entry. 


so that only 
printed for 


Sets the output format to long form, 
default value. 


This is the 


Where 
consul 
wh i c h 
LIMIT 
short 


n ls a number from 1-30, cause 
y° u before typing information for 
has more than n entries. The default 
is 5. The limit setting is ignored 
i.orm of output is requested. 


s INDEX to 
any topic 
value for 
when the 
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LPT 

TTY 

HELP 

STATUS 

SWITCHES 

COMMENT 

STOP 


If you are using INDEX while logged into the DEC-10, 
this command will cause the output to be sent to the 
Line Printer rather than the terminal. 

Causes output to be typed out at the terminal. This 
is the default. 

Asks a question which allows you to choose between 
listing these commands or getting information on the 
program HELP. 

Types the current status of the command options. 

Describes how to use the commands as temporary 
switches . 

Allows you to enter a one line comment about INDEX 
which will be seen by SUCC staff. This can be used 
to comment on an entry or to suggest an entry that is 
missing . 

Stops program execution. Program execution is also 
stopped if you press return immediately after the 
prompt . 


The commands SHORT, LONG, LPT, TTY and LIMIT may be entered one 
per line following the prompt, or they may be entered on the same 
line as a request for information. When entered following a request 
for information, the command must be preceded by a /; when they, are 
entered following the prompt, no / is used. Commands entered with a 
request for information are temporary switches; that is, they affect 
only that one specific request. Commands entered on lines by 
themselves are permanent; they will remain in effect for all 
subsequent requests for information, or until canceled by another 
command. For example: 


* STATISTICS/ SHORT 

will cause the output to be printed in short format for this request 
only, while 

*SHORT 

^STATISTICS 

will cause the output for STATISTICS and for all subsequent requests 
to be in short format. To resume printing with the long format, 
enter LONG. 
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INDEX and the DEC-1 0 

^The INDEX system may also be used when you are logged into the 
DEC-iO. To use the INDEX system when logged in, give the INDEX 
command to the monitor and proceed as described in this memo. When 
the DLC-10 is not available, you may not use the INDEX system at 

31 1 • 


MAINTAINING THE INDEX SYSTEM 


SUCC staff attempts to 
and depends on informati 
departmental entries 
incorrect, or know of a 
in the INDEX system, 
notify the AID Office at 


keep Computing Center INDEX entries current 
on from the various departments to keep 
current. if you find an entry which is 
program or package which should be included 
please use the COMMENT facility of INDEX or 
116 Machinery Hall, Extension 3-3424. 
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This memo is directed to APL users who have such large program 
packages that WS FULL errors are troublesome. We describe a scheme 
whereby an existing workspace may be easily modified so as to store 
some or all functions from it in the SHARP APL File Subsystem, thus 
making storage space previously occupied by those functions 
available in the workspace. In general, a package so modified will 
be considerably slower and will cost somewhat more to run than 
before. It is difficult to be specific as to the precise impact 
upon an arbitrary workspace, so users are advised to experiment with 
this approach before committing to it heavily. 


The following characteristics of the approach are claimed: 


1. No knowledge of QCR, QF£ or the file system is needed. 

2. Any function (with one exception, discussed below) may 
be moved into the files. In particular, one can take 
an existing workspace, written without planning for the 
possibility of file-resident functions, and apply this 
approach to it with a high level of confidence that the 
package will continue to operate correctly. 

3. The normal APL function editor is used to edit file- 
resident functions. 

4. At any time, all file-resident functions may be moved 
back into the workspace, subject of course to WSFULL 
restrictions . 

5. Each file-resident function has an "anchor" function in 
the workspace which occupies less than 100 bytes of 
storage . 

6. )FNS lists all functions of the workspace, whether or 
not they are file-resident. 


Readers not familiar with QCR and []FJ may wish to skip to the 
section entitled "Using the System." 
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Method 


To make an APL function file resident, we divide it into two 
parts: an ’'anchor’* function, which remains in the workspace, and a 
canonical representation matrix of a "body” function, which is 
stored as a component of a file. For example, the function 

V R+MYFUN G\I; J 

[ 1 ] I*?G 

[2] J*I\G 

[ 3 J R+-I*J*G 

V 

has an anchor function 

V R*- MY FUN G ; A 

[1] INVOKE n 

[2] A 

V 

where "n" is a file component number assigned to this function, and 
a body matrix , 


A ;hJ 
I-?G 
J+-I | G 


The ’’anchor" function is formed by taking the original function 
header minus local variables, adding a local variable ,! a ! i , and 
attaching two (standard) new lines. The "body" matrix is formed 
from the canonicalrepresentation matrix of the original function by 
changing the first row to be "a", followed by the original local 
variable list. 

To see how this new function/matrix pair is executed, we 
observe that the function INVOKE simply locates (in the appropriate 
file) the "body" matrix which was formed from the function named by 
its argument (in the case "MYFUN"), reads it into the workspace, and 
applies QFZ thereto, always producing a function named "A". The 
second line of the "anchor" function then executes "a". 

Claim: The " anchor/ body" function pair executes equivalently 
to the original function. 

We observe that syntactically, the "anchor" function is 
identical with the original function. Therefore, any proper call on 
the original function will perforce be a proper call on the 
"anchor”. The INVOKE function simply brings into creation a "body" 
function identical to the "body" matrix already described, and the 
second line of the "anchor" function executes this new function. We 
note, however, that there are differences between the environment in 
which the "anchor/body" functions execute and that of the original 
function : 
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1. The name "a" has been added to the environment.' Clearly 
this name should not be used for any other purpose in the 
workspace. Also note, however, that any valid APL 
identifier may be used instead, and it does not have to be 
the same for each function -- merely it must be consistent 
within the " anchor/body" pair. 

2. The SI stack is twice as deep as it normally would be. 

3. An additional file tie is in existence, this being the file 
containing the "body” matrices. INVOKE could UNTIE its 
file just before exiting, but this would considerably slow 
things down. 

4. If the original function sets either its own trace or stop 
vector, it will now be setting it on the "anchor" function 
instead of the "body" function. 

A note on efficiency: P.ecursive functions will work under this 

scheme, but they are very slow. 


File Structure 


Persons not familiar with the SHARP APL File Subsystem may wish 
to omit reading this section as it is not essential for using this 
system . 

A single file is used for storage of filed functions. Component 
1 is not used, following the convention of always reserving it to 
contain a natural language description of the file. Component 2 is 
a character vector which begins with a carriage return character 
(CR), followed by zero or more names of functions separated by the 
CR character. The first identifier in the vector names the function 
whose "body" matrix is contained in component 3 of the file. 


Using the System 


Please note that all functions and variables described herein 
may be copied from the public workspace CRFX in library 18. In 
particular, there is a group named SPACEGROUP which contains all 
functions, variables, and keywords which are necessary for the 
package. 
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It is, of course, necessary to have a file in which the "body” 
canonical representation matrices will be stored. Thus a file quota 
of at least 1 is necessary for the APL account which will be used. 
A file reservation limit of at least 50,000 bytes is also required. 
(This can be shaved to a certain extent.) Run the function 
INITIALIZE to create the file and initialize it. The name to be 
assigned to the file will be requested. I follow a practice of 
assigning the same name to the file as the workspace with which it 
will be used, since one can think of the file as just an extension 
of the workspace. The global variable SWAP is created by 
INITIALIZE, holding the name selected for the file. After the file 
is established, the functions INITIALIZE and REPLY may be erased. 


Functions are changed into "anchor/body" pairs (and vice-versa) 
by the SWITCH function. It takes as its argument a character scalar 
or vector naming the function which is to be operated upon. If the 
function exists solely in the workspace, then it is disembodied, the 
canonical representation matrix of. its body going to the file, and 
the function itself being replaced by the appropriate "anchor" 
function. Conversely, if the designated function was previously 
SWITCHed into the file, then the "anchor" function and "body" matrix 
are merged to regenerate the original function. 


SWITCHing a function is similar to editing it with respect to 
whether a )SAVE should be done afterwards. If a SWITCH is done and 
the workspace is not saved then the next time the workspace is 
loaded it will appear as if the SWITCH had never been done. The 
effects of SWITCH are made permanent by following it with a )SAVE. 
A double SWITCH is permanent, however, if the function was in the 
file to begin with. Specifically, if a SWITCHed function is brought 
into the workspace for editing and is then SWITCHed back into the 
file, the effects of the editing are permanent, regardless of 
whether or not the workspace is saved. 

A function is edited by SWITCHing it into the workspace (if 
necessary) and then using the normal APL function editor. In 
general, It is convenient to leave the function in the workspace 
while debugging proceeds, only moving the function into the file 
when all editing is finished. 

If it is desired to count the invocations of file-resident- 
functions, then the lamp symbol should be deleted from line 5 of the 
function INVOKE, and a vector called COUNTS should be initialized 
with as many elements as there are file-resident functions. 
Displaying the second component of the file will reveal the names of 
all file-resident functions: the elements of COUNTS are considered 
to be in the same order as the names. 
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PURPOSE 


This utility may be used to move data existing in the 370 
batch environment into SHARP APL files. Specifically, any OS data set 
conforming to certain restrictions detailed below may be translated 
and reformatted into a sequence of APL matrices which become the 
components of a SHARP APL file. 

INPUT DATA 


The data set to be moved into APL must be accessible 
sequentially and is preferably composed of fixed-size records. 
Variable-length records may be used but with due regard for the manner 
in which they will be read by the utility (discussed in detail in a 
later section). The data within a record must be so placed that it 
can be processed by a format control string similar to that employed 
in a Fortran FORMAT statement. This requires that the data be in 
fixed locations within a record, and that the records all be alike in 
this respect. 

CONTROL DATA 


The control data set consists of a set of APPEND statements 
which will control the operation of the utility. An APPEND card is 
written as follows: 

6 ’ f / # J 

'libnum fileid :passnum' APPEND shape RHO ' format 1 


The fields are defined as follows: 

' libnum f ileid : passnum 1 

This field identifies a SHARP APL file called fileid 
and located in library libnum . The file must give ''OAWENB 17 
and "OREAD" access, to user 1000 under the passnumber 
passnum . The file must exist at the time the utility is run. 
The file may be tied non-exclusively at a terminal while the 
utility- is running. A full tie at a terminal will cause 
APLIN to abend. 


shape 

This field is a numeric vector specifying the shape of 
the components (as one would specify on the left-hand side of 
the APL operator p) to be appended to the file. 


' format' 


This field supplies a Fortran-like formatting string 
which is used by the utility to translate the OS data into 
APL data. The details of writing formats is given below. 
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UTILITY OPERATION 

Using' the information on the APPEND card(s) the utility 
constructs a pseudo-workspace containing a matrix corresponding to 
each APPEND statement. Call these matrices HI, M2, — ,Mn. The 
shape of each matrix is just the shape specified on the corresponding 
control card . 

The operation of the utility may then be described 

approximately as follows: 

A: Read a record from the input data set. 

B: Using the format string specified on the first APPEND 

statement convert the record into an APL vector (of a 
numeric or character type as appropriate). This vector 
then becomes a new row in Ml . 

C: Step B is repeated for M2,...,Mn. Note that this sequence 
is carried out with the same data read in step A. 

D: Steps A, B, and C are carried out until one or more of 

the matrices becomes full. 

E: When a matrix fills up it is appended to the appropriate 

file. The matrix is then cleared and the processing of 
the matrices is resumed. 

F: The above steps are carried out until the input data is 

exhausted. At this time all partially filled matrices 
in the pseudo-workspace are forced out to their files. 


FORMAT STRINGS 

Valid format types are: E, F, I, U, A, and X. These 

function as follows. 

Ew ,d 

w characters from the input are 
converted to a single APL number. 
There are d digits to the right of 
the implied decimal point unless 
the input field contains an 
explicit decimal point. A scaling 
factor of the form En , E-n, or E+n 
may appear in the input. 


Fw .d 


like Ew.d except no E may appear in 
the input. 
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Iw 

w characters from the input are 
converted to a number (but no 
decimal point may appear in the 
input, only digits). 

UJL and AA 

both these formats take a single 
character from the input into an 
APL character. The U1 version does 
absolutely nothing to the character 
except move it, while the A1 form 
> also performs a translation from 

EBCDIC to Z-code (EBCDIC=Ex tended 
Binary Coded Decimal Interchange 
Code, used extensively on the IBM 
370, and Z-code is the character 
coding used internally in APL). 

X 

causes the next character in the 
input to be ignored. 


Placing a repetition count in front of any format 
causes that format to be repeated that many times. 
Examples of formats: 

E13.4 E9.0 2F15.1 316 1 7A 1 80U1 IX 15X 

Both the repetition count and the various field width 
specifications must be decimal numbers less than 256. 


SPACE CONSIDERATIONS 

The A and U formats create character-type APL structures 
exclusively. E and F create only real, double-word types. Mixing 
E and F with I type fields also causes generation of real 
results. I fields used by themselves and restricted to a field width 
of 9 or less generate integer, single-word results. 


EXAMPLE 

In this example it is assumed that a card deck exists which 
is to be placed into a SHARP APL file. Each card in the deck consists 
of a 10 character field occupying the first 10 columns of the card and 
6 integers, each occupying successive 4-column fields. It is desired 
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to place these cards into two separate files, one containing the 
alphabetic labels, the other the numeric fields. Specifically, one 
file, called LABELS, is to be composed of matrices, 20 rows by 10 
columns, where each row will be a label from a card, and a second 
file, called NUMBERS, will consist of 20 by 6 matrices, where each 
row of 6 elements will be 6 integers taken from a single card. The 
following outlined steps will carry out this objective. 


CREATE FILES 


To create the SHARP APL files the following lines of 
APL might be executed at a terminal. Assume the APL 
account number of the user is 12345678. 


'LABELS' QC RE ATE 1 
(1 3p 1000 "l 987) QSTAC 1 
' NUMBERS' □ CREATE 2 
(1 3p 1000 ”1 756) USTAC 2 
UUNTIE 1 2 

Note that the second line above places the following 
matrix into the "access matrix” of the file called 
•LABELS' : 


1000 “1 987 


RUN UTILITY 


The following job is run to transfer the card deck 
into the SHARP APL files created above. 

APL MUST BE UP WHEN THE UTILITY IS RUN! 


/iJOBNAME JOB 
//sTEPT~Exircr 




>1 


-pottHTtrarr" 

//FT01F001 DD * 

•12345678 LABELS:987 
' 12345678 NUMBERS:756 

/* 

/ /“FT 0 1 F O02~frD * '-?/ \ff 


REGION = 200&1 




At) 


APPEND 

APPEND 


20 

20 


RHO 

RHO 


10A 1 • 

1 OX, 614’ 


at 


4* 

'//¥ > 

U f 701 


PO (/. LT t j OtF > ere) / fat,- it*.*? *99} 
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/* 

//FT03F001 DD SYSOUT=A,DCB=(RECFM=UA,BLKSIZE=133) 
// 


The following output will be received from the utility . 

APLIN UTILITY 
CONTROL CARD ANALYSIS 

‘12345678 LABELS :X‘ APPEND 20 10 RHO MOA’ 

FORMAT WILL USE 10 BYTES OF EACH OS RECORD 
—AND WILL PRODUCE 101 ITEMS FOR APL 


‘12345673 NUMBERSrX’ APPEND 20 6 RHO *10X,6I4‘ 

FORMAT WILL USE 34 BYTES OF EACH OS RECORD 
— AND WILL PRODUCE 6 ITEMS FOR APL 


EOF ON CONTROL DATA SET 

MAX READ= 34 

BSS CONNECTION ESTABLISHED 

PRESENT FILE SIZE INFO FIRST COMP NEXT BYTES USED MAXIMUM 
12345678 LABELS 1 10 50184 

12345678 NUMBERS 1 1 0 50184 


NEW FILE STATUS 

12345678 LABELS 1 5 1836 
12345678 NUMBERS 1 5 3060 
FILES UNTIED - NORMAL UTILITY TERMINATION 


50184 

50184 


Note that 4 components were written to each file (the 
next available component is 5, not the last one 
written) . This axso implies that exactly 80 data cards 
were read. If the number of cards read is not exactly 
enough to fill the mat-rices an integral number of times 
then the last component in each of the affected files 
will be reduced in size as necessary. In the above 
example, suppose that only 75 data cards were present 
in the input deck. Then only enough data to fill 15 
rows of the “last" matrices would have been available. 
In that situation the following message would have been 
printed : 
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12345678 LABELS SHAPE OF LAST COMPONENTS 15 10 
12345678 NUMBERS SHAPE OF LAST COMPENENT= 15 6 

The message "FORMAT WILL USE ..." refers to the number 
of card columns which will be processed by the format 
statement appearing on the APPEND card, and how many 
APL-type values will be produced thereby. Note that 
after all of the control deck has been processed the 
utility picks the largest input value and prints it 
under th e message "MAX READ". This is the number of 
bytes which will be read from the data set each time a 
read is performed (see step "A" of the program outlined 
under "UTILITY OPERATION" above). In this example, the 
smallest read which can be performed on the data set- is 
80 bytes (the length of a card) so 80 bytes, not 34 , 
were read each time. If MAX READ is greater than the 
length of the shortest record then an I/O error with 
subsequent ABEND will result. 


RUN TIME ESTIMATES 


In the example as given above, a cost of about $1.35 per 
thousand data cards will be incurred. Note that this figure is 
subject to wide variations depending upon the exact formats chosen, 
size of matrices employed, etc. The "Equivalent Time Estimate" for a 
job similar to that illustrated needs to be about 12 seconds per 
thousand cards processed. 


EBCDIC TO Z-CODE TRANSLATION 


The "A" type of format implies a translation from EBCDIC 
characters to APL Z-code representation. The exact translation is 
discussed in CCIS Memorandum LA17. In general, however, the alphabet 
and numbers are translated properly, as are most of the special 
characters in common between EBCDIC and APL (,.;:'= _-+*$()/?). 

ABEND CODES 

An ABEND of 3056 indicates that the SHARP APL files system 
was not available when the utility was run. Any of the following 
codes indicate that the APLIN utility attempted to use the system 
incorrectly, and should be brought to the attention of the author. 


3051 3052 3053 3054 3050. 
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1 . Introduction 


This memo deals with batch processing jobs, or simply, batch 
jobs. Batch jobs on the System/370 at this installation comprise 
all jobs which do not use one of the time-sharing systems (such as 
APL, ATS or the DECsystem-1 0 ) . 

Batch jobs may be submitted either in card deck form or from a 
terminal. In either case, once inside the machine, all batch jobs 
form a queue called the input queue; each job in the input queue is 
distinguished from the preceding job by the JOB card. Hence, the 
first card of each job that is submitted for processing must be the 
JOB carcT 


2. General form and definition of the JOB card 


The general form of the JOB card is: 

//j JOB (a,d,t,l,c,p) ,'m' ,REGION=nK 
accounting field 

The symbols in lower case letters represent specifications to 

be made by the user and are defined as follows: 

j --- the job name which can be any name or string of 

less than or equal to eight alphameric or national 

characters starting with an alphabetic or national 
•($,#,§) character. 

a the account number (1 to 8 digits) assigned to the 

general user by the Center when he files a Computer 
Usage Application, or the mannumber (5 to 8 digits) 
assigned to a student user by his instructor, or 
the mannumber (5 to 8 digits) assigned to a 
programmer by his project director. This parameter 
is required. 

d — — for the general user, the parameter d is the 

department code or account code (password) 

determined by arrangement with the Business Manager 
of the Computing Center. For the student user, the 
d parameter is the code prescribed by his 

instructor. This parameter is required. 

t the estimated maximum equivalent time allowance for 

the job. The time parameter t may be given in the 
form aHbMcS where a, b, and c are integers 
specifying a number of hours, minutes and seconds, 
respectively. Parts of the specification may be 
dropped. For example, 7H and 3M45S and 95S are 
valid time specifications. If two or more parts of 
the specification appear, each number must be less 
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than the corresponding conversion factor. For 
example, 95S and 1M35S are valid, but 1M65S is 
invalid. The parameter t may also be stated simply 
as an integer, whereupon this is taken to be the 
time in minutes. This parameter may be omitted. 
If it is not specified, then a default value of two 
minutes is assumed. 

1 the estimated maximum quantity of printed output 

that can be generated by the job. The lines 
parameter 1 may be given in th- form of dL, or eK, 
or f, where d, e, and f are int« *ers. dL is taken 
to mean d lines of print, eK n ans e thousands of 
lines, and f (an integer without any modifiers) is 
also taken to mean thousand. of lines. The 
parameter 1 may be omitted, wh reupon a default 
value of 2K lines is assumed. 

c an integer specifying the estimated maximum number 

of cards that may be punched by tie job. If the 
cards parameter c is omi ted, a c. efault value of 0 
(i.e., no punched output) ! s assured. 

p the estimated maximum d awing time needed to 

produce output on the Calcor, Plotter. The plot 
parameter p may be specifier' in the same manner as 
described above for the time parameter. If the 
parameter p is omitted, a default value of 0 (i.e., 
no plotted output) is assumed. 

m the user’s name; this field need not be put in 

quotes unless a special character (or a blank) is 
used. The length of this field must be less than 
or equal to 20 characters. Usually this field 
should contain the programmer’s last name 
optionally followed by his first name. The name 
parameter m must be specified. 


3 . The REGION parameter 


The keyword parameter REGION is used to specify the amount of 
main storage which is to be allocated to the job. If the REGION 
parameter is not specified on the Job card, the job is assigned a 
default REGION size of only 50K (K = 1 024 ) bytes. Although a few 
programs, including the IBM utility programs, will run in 50K, most 
processors at this installation require larger amounts of main 
storage. REGION requirements for most processors used at this 
installation are given in the CCIS memo S1 14 ’’REGION Requirements 
for Common Processors at SUCC” . Copies of this memo are available 
in the AID Office. 
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The user requests the amount of main storage required for his 
job by coding 

REGION=nK 

where n is an even integer. This requests n 1024-byte areas of main 
storage. Rules for punching the REGION specification are given in 
section 5 of this memo . 


The maximum main storage allocation that can be obtained 
depends on the time of day at which the job is to be run and these 
limits may change periodically as the configuration of the 
supervisor is changed. The job may be submitted at any time, but 
if, when the job would normally execute, the requested main storage 
allocation cannot be provided, the job is held in queue until the 
requested amount of storage is available. If execution of a job is 
initiated but a request for main storage cannot be satisfied, then 
the job is terminated with a SYSTEM=804 or SYSTEM=80A error code. A 
REGION parameter specification for a job step on an EXEC card is 
ignored at this installation. 


4 . Additional parameters 

In addition, two optional keyword parameters may be specified 
following the name field. They are: 

MSGLEVEL=0 — - to suppress printing of JCL statements. 

COND=(specs) to determine bypassing of job steps. 

Rules for punching these specifications are given in the next 
section . 


Coding MSGLEVEL=0 on the Job card suppresses the printing of 
all JCL statements except the Job card and those JCL statements in 
error. If the MSGLEVEL parameter is omitted, then MSGLEVEL=1 is 
assumed at this Center which results in all JCL statements being 
printed on the second page of the output. For more information and 
other options you can specify using MSGLEVEL refer to the IBM Job 
Control Language manual, Form GC28-6704. 

Coding COND=(specs) on the Job card, where specs are as 
described in the IBM manual mentioned above, allows the user to 
determine whether subsequent job steps are to be executed . 


5 . Rules for punching the Job card 

The rules for punching the Job card are: 

. // must appear in card columns 1 and 2, 

. the job name must begin in column 3, 
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the verb, JOB, must appear next (separated from the 
job name and the accounting field by blanks) , 

the set of parameters in the accounting field must 
be enclosed in parentheses as shown, 

parameters must be separated from each other by 
commas; no blanks are allowed, 

if certain parameters of the accounting field are 
omitted and other accounting field parameters 
follow, then the comma following the omitted 
parameter must still be punched, 

if REGION, MSGLEVEL or COND are coded they should 
follow the programmer’s name and be separated from 
it by a comma. If more than one of these are coded 
they should be separated from each other by a 
comma , 

blanks are permitted only before and after the 
verb, JOB, and within the single quote marks of the 
name field, or following the last parameter on the 
card, and 

if all the information does not fit on one card, 
the user may continue onto the next card subject to 
the usual continuation rules for JCL cards; i.e., 
he must stop keypunching the card at a comma 
separating parameters, punch // in columns 1 and 2 
of the next card, and begin the next parameter 
between columns 4 and 16, inclusive. 


6 . Estimation of parameters 


The following considerations should govern the user’s estimates 
for the time, lines, cards and plot parameters in the accounting 
field. First, the estimates should not be underestimated since the 
job is automatically cancelled as soon as any one of these estimates 
is exceeded with the probable results that the run is completely 
wasted. On the other hand, the estimates should not be excessive 
overestimates, since jobs with smaller estimates, particularly 
smaller time estimates are given higher priority in the job queue 
within the machine. Thus, the safe policy is to specify generous 
estimates on the early runs and then to refine those estimates for 
later runs on the basis of the job statistics for the earlier runs 
which appear on the first page of the printed output. (Warning: 
Untried programs should not be given large time estimates since they 
may become trapped in an infinite loop) . 

The REGION parameter must be coded in most cases, since the 
default main storage allocation (50K as of April 10, 1973) is not 
sufficient for most jobs. For more information concerning the 
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REGION parameter and main storage requirements for the various 
compilers, utility programs and prepared packages of programs, the 
user should obtain a copy of the CCIS memo S1 14 mentioned earlier in 
this memo. One may estimate how much storage a FORTRAN program 
needs for execution by adding 8 to 1 2K to the size listed in the 
program's linkage editor map. In order that several jobs may be 
processed concurrently, the REGION request should be the smallest 
that is sufficient for the job. However, until the main storage 
requirements of a job have been determined, the user should request 
a REGION size that will both accommodate the job and be the largest 
available for a convenient part of the day. 


7 • System response to Job card errors 


The user's account number or mannumber and the department code 
or the account code for every job are automatically checked by the 
operating system. If either is invalid, the job is not run. 
Accounts are also checked for sufficient funds. A time estimate 
message "INSUFFICIENT FUNDS" appears on the first page of the 
output. This is caused by a time estimate that, if actually used, 
would more than use the rest of your account. This misfortune can 
be avoided if the user keeps track of the status of his account 
which appears near the top of the first page of each printed output. 
Any keypunch error on the Job card also causes the job to fail. 
Other system error messages follow: 


1. INVALID CONTINUATION CARD 

2. INVALID DELIMITER 

3. MISSING ACCOUNT NUMBER 

4. MISSING DEPARTMENT CODE 

5. DEPARTMENT CODE EXCEEDS FOUR CHARACTERS 

6. TOO MANY ESTIMATES 

7. INVALID ESTIMATES 

8. INVALID PROGRAMMER NAME 

9. PROGRAMMER NAME EXCEEDS TWENTY CHARACTERS 

10. INVALID DIGIT 

11. NUMBER EXCEEDS NINE DIGITS 

12. INVALID OPERAND 

13. PARAMETER EXCEEDS EIGHT CHARACTERS 
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14. NONCE ERROR - this error indicates that you have tried to 
do something that as of this time is unsupported by SUOS 
or OS or both. Any other occurrence of this message 
should be brought to the attention of the AID Office 
consultant . 

15. OPERATOR CANCELLED INPUT 

16. READER INPUT DEVICE ERROR 

17. MISSING CONTINUATION CARD 

18. MISSING JOB NAME 

19. JOB NAME EXCEEDS EIGHT CHARACTERS 

20. MISSING OPERAND 

21. TIME OR PLOT ESTIMATE TOO LARGE 

22. EXCESSIVE CONTINUATION 

23. TOO MANY SYSIN DATA SETS 

Error codes SYSTEM=804 and SYSTEM=80A, which are generated by 
OS after execution has been initiated, may mean that the REGION 
specification was incorrect. 

If one of these errors should occur when you are trying to run 
a Job, or for an explanation of what these errors mean, check with 
an AID Office consultant . 


8. Passwords for user account numbers 


The user’s account number may be passworded to restrict usage 
of the account number to only authorized users. The account code or 
password replaces the user's department code on the Job card and 
during terminal sign-on. The account code is limited to 1 to 4 
alphabetic characters. This feature is supplemental to the 
department code and has no effect on users who do not request an 
account code. 

Those wishing to use account codes should contact the Business 
Manager, Room 121 MH, x2?75, to specify the desired account code. 
The user should note that it is his responsibility to protect his 
account number and code from unauthorized persons. These two items 
appear only on the user’s Job card. They do not appear on any 
printed output or terminal displays produced in the Center. 
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Examples 


Example 1 . 

/ /EX#1 JOB (234, YUP) , JOHNSON 

The job name for this job is EX#1. Johnson is the programmer. 
In this example all defaults are in effect. At most he can use 
two minutes of equivalent time, produce two thousand lines of 
output. If he exceeds these limits or tries to punch cards or 
produce a plot, his job will be automatically cancelled by the 
operating system. 


Example 2. 

//PLOTTEST JOB ( 1 6820043 , JUMP , , , 300 , 20 ) , ’JOHN DOE * , REGION = 1 20K 

In this example JOHN DOE has used the default values for 
equivalent time and number of lines. However, he can now punch 
up to 300 cards and use 20 minutes of plotter time. Note that 
the output will be placed in the »J S bin and not the 'D ! bin. 


Example 3. 

//$$M0NEY$ JOB (1234, FIVE, 1H10M5S , 100L) , 'GREEN SAM* , REGION=300K 

This job can use u maximum of one hour, ten minutes, and five 
seconds of equivalent time. He is expecting less than 100 
lines of printed output. The output will be placed in the 
correct bin (last name order) . 


1 0 * the SUPS VARIABLE VERB JOB CARD 

A new type of JOB card will be available under SUOS as of 
August 19, 1974. It Is called variable verb JOB card. This 
new type of job card allows you to put the name of any 
catalogued procedure* in the verb field of the JOB card instead 
of the verb 'JOB* (thus the name "variable verb"). SUOS will 
then generate an EXEC card for you and substitute 'JOB* back 
onto the JOB card. The EXEC card will have the procedure name 
in both the label field and the operand field (see example 
below). This JOB card allows you to omit the 'EXEC' card 
completely. An additional feature of using this type of JOB 
card will cause SUOS to check a special default REGION library. 
If the catalogued procedure you are using is included in this 
library, SUOS will automatically use the nonstandard default 
REGION found in this library(See Dispatcher or AID Office for a 
listing of this library) unless the REGION parameter is 
specified on the JOB card. Therefore, if the procedure is 
listed in the REGION library, you can omit both the EXEC card 
and, in most cases, the REGION parameter and your job will run 
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in an appropriate amount of storage instead of the standard 
default of 5QK. A word of caution is in order here, as in some 
applications even the nonstandard default REGION is too small. 
For example, a large PL/C program with several hundred 
statements may not run in the default REGION of 120K. It is 
the programmer’s responsibility to realize that his/her program 
is a special case and that the REGION parameter needs to be 
specified . 

One minor restriction has been imposed on the user of 
this special JOB card. Comment continuation( and only comment 
continuation ) is not acceptable, whereas on a normal JOB card it 
is. An attempt to do so will result in your job being failed by 
SUOS with the message NONCE ERROR (which means you attempted 
something unsupported by SUOS and/or OS). In all other ways 
the variable verb JOB card conforms to the standard rules of 
JCL. 


Example 1 

//VVTESTfl PLC ( 1 234, ABCD) , NAME 

This job card will expand to the following JCL, and since 
no REGION is specified, this job will run in 120K (the default 
for PLC) . 

//VVTEST#1 JOB ( 1234, ABCD) , NAME 
//PLC EXEC PLC 


*See a listing of SYS1.PR0CLIB for the procedures available. 


Example 2 

//VVTEST#2 SPSS ( 1 234 , ABCD) , NAME , REGIONS 50K 
This will expand to: 

//VVTEST#2 JOB (1234, ABCD) , NAME , REG ION =1 50K 
//SPSS EXEC SPSS 

Note that if a FARM must be specified (as is often the 
case with ^ome programs such as SPSS) you cannot use the 
variable verb JOB card since the FARM must be entered on the 
EXEC card. 
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GETTING A D E C - 1 0 FILE PUNCHED ONTO CARDS 

As the DECsystem-10 does not have a card punch, a file must be transferrer 
to the IBM 57 0/ 1 55 which does have a card punch. 

Eelow is a sequence of events in order to punch out a DEC-10 file. The 
user must purchase or arrange to use a magnetic t ape . 

The following instructions are for a disk file named " F00 . DAT" and <= 
tape registered with the number " 9 99 99 9" • The tape will be tranpfered 
as a "non -labeled" tape. 


(1) Obtain a magnetic tape. 



(2) Mount the tape on the DEC-10: 

.MOUNT MTB: FRED: /REELID: 999999 /VID: ' owner 5 MIN'/WE 

3) Copy the file to tape, changing the character set as you go: 

.R CHANGE 1 . , . 

>RETA IN < retains commands until you explicitly execute t 

>FRED:F00. DA T/M0DE:EBCDIC/REC:80/ BLOCK: 1/1 NDUSTRY=DSK:F00. DAT 

{ If you make a mistake, retype the line, that's 
{ what RETAIN is used for. 


> H U N < execute the change program. 

{ Change messages will appear here 

> E X IT 

.DISMOUNT FRED: 





( 4-) — tfo-w— r-un the folJL-OJwing-, b a t c_h 

/V PUNCH JOB — Ja c c t , p s wd , , , c ards ) .name, = 

// /SETUP \TjlPE = ( 999999 ,NL) owner 

\//S99gp DD UNI TV (TAPE, .DEFER) , 

\ER=999999 , 

LABEL V( 1 , NL) , 

\C F M = F , B L K S I ifi. = 80) 


(5) Pi-c/k up punched output in Rm. 122, Machinery Hall. 


If you have any questions, come back to the AID Office. If something 
is or appears incorrect, please tell us. The AID may modify the above 
to suit the situation. Thank you. 





to Rfto 
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TAPEDUMP: A Program to Dump Sequential Data Sets 


I . Introduction 

TAPEDUMP is a general batch utility program for the IBM 
System/370 written at and supported by the S.U. Computing Center. 

It can perform one of three primary functions each time it is 
invoked : 


. Dump the contents of all or part of a sequential file. 

. Print the contents of the labels on a standard labeled tape. 

. Count the numbers of blocks in a sequential file. 

The functions are controlled by optional parameters (discussed 
below); the default is to print the contents of an entire file. 
TAPEDUMP can be invoked by a cataloged procedure of the same name. 

TAPEDUMP recognizes only physical records, or blocks. It does 
not differentiate between the logical records which comprise a 
block. 


The TAPEDUMP output is 
and its length are given before 
messages are produced when a 
the standard ABDUMP format. At 
offset, from the start of the 
on that line followed by 8 
representing 32 data bytes 
character interpretation of 
characters represented by a per 


by physical record; the 
each block printed, 
pplicable. ) Each block 
the left is the 6-digit 
block, of the first char 
groups of 8 hexadec 
from the block. On the 
those 32 bytes with 
iod ( . ) . 


record number 
( Additional 
is printed in 
hexadecimal 
acter printed 
imal digits 
right is the 
unprintable 


II . JCL and Deck Setup 

General form: 

// Job card (See CCIS Memo Gill.) 

// SETUP TAPE= (b,k) 

// EXEC TAPEDUMP, SER = t U^~NL 

// * 

Notes: 

1* ^he SETUP statement, which is a special feature of SUOS, is 
required for tape jobs or the use of non-resident disk 
volumes. (See CCIS Memo SI12.) 

2. b on the SETUP card stands for the tape!s bin number. If 
the tape's bin number (b) is not the same as its serial 
number (t), both should be included on the SETUP card. 

3. k on the SETUP card is to be replaced by either NL for a 
non-labeled tape or SL for a standard labeled tape. 
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^ • t on the EXEC card stands for the tape's serial number. 
For standard labeled tapes this number must be the same as 
the volume serial number in the magnetic tape label, which 
is not necessarily the same as the number on the outside of 
the tape reel. For non-labeled tapes the serial number 
should be the same as the number on the outside of the tape 
reel. 

5. Certain other optional parameters, which are described in 
Notes (6) through (10) should be coded on the EXEC card as 
circumstances dictate. They should be coded in any order 
following the SER parameter, separated from it and from 
each other by commas, and have no embedded blanks. Coding 
may have to be continued onto subsequent cards according to 
the standard JCL rules. 

6. For standard labeled tapes the data set name (dsname) for 
the appropriate file must be coded as 

DSN= ’ dsname ’ 

7. The program ordinarily processes, or begins processing at, 

the first file on the tape. To process, or begin 

processing at, some other file (say f ) , the user should 
also code the following parameter on the EXEC card: 

FL = f 

8. If the tape has no standard label, parameter 

LAB=NL 

should also be coded on the EXEC card. 

9. A program control parameter with the form 

PARM=’q» 

may also be coded on the EXEC card. It is described in 
section III. 

10. For a data set on disk, the following parameters are 
needed: 

SER = t , DEV=d , DSN = * dsname’ 

where t is the volume serial number of the disk pack, d is 
the device specification number and dsname is the data set 
name. LAB and FL parameters should not be coded. If the 
data set is cataloged, the t and d may be omitted, but the 
SER= and DEV= must still be coded. The parameter would 
then be: 

SER= , DEV= , DSN= ’dsname* 

11. The default values for the various parameters are: 


LAB=SL , FL= 1 , DSN=NONAME , DEV=TAPE , DEN=4 , TRTCH= , PARM= 
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III. Program Options ° The PARM Field 

A. To dump an entire file: 

You may dump an entire file by omitting the PARM field on 
the EXEC card. 

B. To dump specific records: 

You may restrict the number of records to be dumped by 
coding on the EXEC statement: 

PARM= * nnTOmm* 

where nn is the starting record number and mm is the 
stopping record number. (Note: A record in TAPEDUMP is a 
block . ) 

C. To obtain a listing of record sizes and whether an I/O 
error occurred: 

You may inhibit the actual dump by coding or. the EXEC 
statement : 

PARMs* nnTOmm, NODUMP » 
or 

PARM= * , NODUMP * 

There are no spaces in the PARM specification. The comma 
is important. 


D. To list all volume and data set labels: 

You may use TAPEDUMP to list all volume, data set, and 
user labels from any standard labeled (SL) tape or standard 
user labeled (SUL) tape by coding on the EXEC statement: 

PARM= * , LABELS’ 

The comma is important. There are no spaces in the PARM 
specification. 
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IV. Program Restriction 


A. TAPEDUMP stops processing with the LABELS or NODUMP option 
for an NL tape when two consecutive tape marks are 
encountered. TAPEDUMP will continue past an empty data 
file on an SL or SUL tape. Termination occurs when two 
consecutive tape marks are found following trailer labels. 


V. Examples 


A. To dump all of the first file on a standard labeled 9-track 
tape 324761. 


// Job Card 

// SETUP TAPE=(324761 , SL) 

// EXEC TAPEDUMP, SER=324761 ,DSN=’TESTDATA* 
// 


B. To dump an entire disk data set on a 3330 disk unit. 
// Job Card 

// EXEC TAPEDUMP, SER=SU0002, DEV=3330, 

// DSN= 1 COMP0935 . TESTDATA 1 

// 


C. To dump records 10 through 20 from the second file of a 9- 
track tape (116372) with standard labels. 

// Job Card 

// SETUP TAPE=(1 16372, SL) 

// EXEC TAPEDUMP, SER=1 16372, PARM= ' 1 0T020 ' , FL=2 , DSN= » ABC . F2 ’ 
// 
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To dump the first 20 records of an 1600 BPI tape (111234). 

// Job Card 

// SETUP TAPE=(1 1 1234, NL) 

// EXEC TAPE DUMP, SER=1 11234, LAB=NL, DEN =3 
// PARM= ■ 1 T020 ' 

// 


To list the record sizes for the second file of a non- 
labeled 9-track tape 3264 and determine whether I/O errors 
occurred . 


// Job Card 

// SETUP TAPE= (3264 , NL ) 

// EXEC TAPE DUMP ,SER=3264,LAB=NL,FL=2,PARM=',N0DUMP' 


F. 


To list 
205151 . 


all volume and data set labels from 9-track tape 


// Job Card 

// SETUP TAPE= (205 151 , NL ) 

// EXEC TAPE DUMP, SER=205 1 51 , PARM= ' , LABELS ' , LAB=NL 


G. To dump the first 2 blocks of a cataloged disk data set 
(volume location unknown): 

// Job Card 

// EXEC TAPE DUMP , SER= , DEV= , DSN= 'MYLIB ’ , PARM = * 1 T02 ' 
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APPENDIX 


Cataloged Procedure TAPEDUMP 


// PROC DEV=TAPE , SER=NONAME, FL=1 , LAB=8L , 

// DEN=4 f TRTCH=,DSN=NONAME 

//DUMP EXEC PGMsTAPEDUMP 
//SYSPRINT DD SYSOUT=A 

/ / SYSUT 1 DD UNIT=(&DEV, , DEFER) , 

// DISP=SHR , 

// VOL=SER=&SER, 

// LABEL= (&FL, &LA8, , IN) , 

// DSN=&DSN , 

// DCBs(RECFM=U t BLKSIZE=32760,DEN=&DEN,TRTCH=&TRTCH) 



SYRACUSE UNIVERSITY COMPUTING CENTER 


INFORMATION SERIES 



0 


3 

DOCUMENT 

11 


] 


0 

TITLE 

3 

TX2-1 1 1 1 

11 




1 

SOS 

] 


B 

A Line Oriented Text 

3 

DATE 

B 

Editor Used on the 

] 


B 

DECsystem- 1 0 

] 

12/13/78 

B 


3 


0 


3 




] 

AUTHOR: 



3 



John Thornton 

3 




1 


AUDIENCE: 
COMPUTER(S) : 
LEVEL: 


DECsy stem- 1 0 Users 

DECsy stem- 1 0 

Part 1 - Introductory 
Part 2 - Intermediate 


REFERENCES: Supersedes CCIS Memo P21-1082, titled as above. 


ABSTRACT: 

This memo is in two parts. Part 1 is designed as a brief 
introduction to the most basic commands of SOS. It is intended that 
Part 1 will give the novice user enough information to use SOS for 
file creation and simple editing. 

Part 2 is for the more advanced user. It describes all of the 
SOS commands in some detail. 


25 Pages 


$0.50 




INTRODUCTION TO SOS TEXT EDITOR 


CONTENTS 

INTRODUCTION 2 

PART 1 . s 2 

PART 2 . 7 

CHAPTER I - Backup Files and Exiting SOS 7 

CHAPTER II - Pointer Movement and Line References .. 8 

CHAPTER III - Insertion ...10 

CHAPTER IV - Substitution 12 

CHAPTER V - Copying Lines 13 

CHAPTER VI - Joining Lines ..14 

CHAPTER VII - Renumbering Lines 15 

CHAPTER VIII - Paging 16 

CHAPTER IX - Case Changes 17 

CHAPTER X - Miscellaneous Edit Mode Commands 18 

CHAPTER XI - Miscellaneous Alter Mode Commands 19 

CHAPTER XII - Switches and Parameters 21 

APPENDIX A - Angle Bracket Definitions 25 

APPENDIX B - Switches and Parameters 26 

APPENDIX C - Edit Mode Commands 27 

APPENDIX D - Alter Mode Commands ...28 




TX2 


2 


TX2 


INTRODUCTION TO THE SOS TEXT EDITOR 


SOS is a line-oriented text editor that allows users to create 
and edit files on the DECsystem-10 . SOS has three modes of 
operation: input mode — for creating new files, edit mode — for 
correcting a file line by line, and alter mode — for editing 
character by character within a line. 

SOS begins by assigning a number to each line of the file. 
When an editing action is to be taken, the line to be edited is 
referenced by its line number. SOS commands are simple to use. 
Normally, a_command is a single letter followed by a line number or 
a range of line numbers. SOS allows you to create new lines, get 
rid of unwanted lines and correct parts of existing lines. 

The SOS. monitor command is used to run the SOS editor. The 
same ^command is used both for creating and for editing files. If 
the filename used does not exist in your directory, then SOS assumes 
you want to create a new file (Input mode). If, however, the file 
was previously created, then SOS assumes you want to edit the file 
(Edit mode) . 

This, memo is in two parts. Part 1 is designed as a brief 
introduction to . the most basic commands of SOS. It is intended that 
Part 1 will give the novice user enough information to begin using 
SOS. for file creation and for simple editing. Part 1 begins with 
definitions of some words and symbols used in this memo. Then the 
most common commands of the three modes are explained. 

Part 2 is for the more advanced user. It describes several 
topics and the SOS commands involved. The topics include backup 
files, paging and pointer movement. There is a great deal of 
information included in Part 2, Therefore, it may be desirable to 
study topics as they are needed. The appendices are designed to be 
quick reference charts for the commands and parameters of SOS. 


PART 1 


DEFINITIONS 


escape escape is entered by pressing the escape key 

(labelled ESC) when working at a DECwriter, or by 
typing control- [ (left bracket). NOTE: When the 
escape key is pressed, the computer will type a $ 
indicating that escape was entered. However, the $ 
key does not give the same results as pressing the 
escape key. All $'s in this memo represent pressing 
the escape key. 
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<cr> represents a carrier return, i.e., pressing the 

RETURN or NEWLINE key. This key should be pressed at 
the end of each line that is typed, whether a command 
or input. 

<space> means the space bar is pressed. 

<tab> means the tab key is pressed. 

<bksp> means the backspace (labelled BKSP) key is pressed. 

<1 ine f eed> means the line feed is pressed or alternatively 

control-J is typed. 

dine numbed Any other item that is enclosed in angle brackets is 
to 'be replaced by the appropriate value of whatever 
is described. (All the angle bracket items used in 
this memo are defined in Appendix A). For instance, 
dine numbed should be replaced by the line number 
desired. Another example is: 

<string> A string is any combination of characters 
(letters, numbers, blanks, punctuation 
marks, etc.). A string can contain zero or 
more characters and is normally ended by 
pressing the escape key. 

prompt SOS generally types out a symbol to indicate that it 

is waiting for input or for a command (input when the 
prompt is a line number; a command when the prompt is 
an *) . NOTE: alter mode does not give prompts. 

Lines in the file can be referenced by either of the following: 

1. dine numbed - an integer between 1 and 99999. 

2. dine number >: <1 ine numbed - to refer to a 
range of lines. 

100:400 means lines 100 through 400. 


INPUT MODE 

This mode is used to type in a new file (program, data or 
text) . To enter this mode, give the SOS command followed by an 
unused filename (for instance, SOS TESTB.FOR). SOS will respond 
with a line number, after which the next line of the file is typed. 
To exit from input mode, press the escape key; SOS will then enter- 
edit mode. 

To summarize, writing a new file involves three steps: 

1. give the SOS monitor command. 

2. type in the file, line by line, after prompts. 

3. press the escape key to leave input mode. 
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EXAMPLE: (underlined information was typed by SOS) 

^SOS ONE. FOR 
INPUT: ONE. FOR 
00100 <TAB> 1=1 
00200 <TAB> TYPE 10,1 
00300 10<TAB> FORMAT (15) 

00400 <TAB>END 

00500 $ (THE ESCAPE CHARACTER) 

* 


EDIT MODE 

Edit mode is entered either by giving the SOS command followed 
by the name of a previously written file, or by pressing the escape 
key while in input mode. Edit mode will type out asterisks as 
prompts . 


EDIT MODE COMMANDS 

P Print (on the terminal) the lines indicated. 
P100 

P100: 500 


I 


D 


Insert the line indicated. (If the 
SOS will insert between that line 
NOTE: SOS will continue to insert 

until the next line is reached or 
pressed . 


line number already exists, 
and the following line) . 
lines, incrementing by 100, 
until the escape key is 


1100 

1350 


Delete the indicated lines from the file. 


D100 

D700 : 1000 


R Replace the indicated lines. Equivalent to deleting the lines, 
then inserting the same lines. 

R100 (equivalent to D100 then 1.100) 

R400:70G (equivalent to D400:700 then 1400) 

S Substitute one string for another. The format is SCold 
string> $<new str ing>?<line number>, where each string is 
ended by pressing the escape key. The effect is that the new 
string is substituted for the old string in the line indicated. 
NOTE: If the old string occurs more than once in the line 

indicated, each occurrence will be substituted. For more 
information on this command, see Chapter IV of Part 2. 
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E Exit from SOS (return to the monitor ) and store the file. 

W "Save World," i.e., store the file as it is now, hut continue 

editing . 

ES Strip (remove) the line numbers, then exit from SOS and store 

the file. This command must he used for data files. If not 
used, the line numbers remaining as part of the file will ’un- 
treated as data. Note that if any editing is done, the line- 
numbers may be different when SOS is reentered. 

A Alter the lines indicated, one by one (enter alter mode). 


ALTER MODE 

This mode is entered by giving the alter command while in edit, 
mode. While in alter mode, one can move back and forth within the 
line, changing, deleting and inserting characters in the line. This 
mode maintains a pointer which points to a character in the line. 
The pointer may be moved by using any of the first four commands 
below. The following four commands act on or before the character 
indicated by the pointer. NOTE: Alter mode does not give prompts, 
nor does it print the user's commands. 


ALTER MODE COMMANDS 

<space> Pressing the space bar will move the pointer forward 

one character. 

<bksp> Pressing the backspace key will move the pointer one 

space backward. 


1 (the letter i) This command will print the line and 

return the pointer to the beginning of the line. 


ns 

S k ip to 

the nth 

occurrence of 

the next char act e 


typed . 





2sc 

(Skip to 

the 2nd c after 

the pointer . ) 


St 

(Skip to 

the 1st t. after 

the pointer.) 


3ss 

(Skip to 

the 3rd s after 

the pointer.) 

nc 

Change 

the next n 

characters (Following the com™ 3 ’-'-’ 


type in the n new characters.) 

ca (Change the next character to an a.) 

2cab (Change the next 2 characters to ab.) 

5cx-y/z (Change the next 5 characters to x--y/z . ) 
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nd 


nr 


<cr > 


Delete the next n characters, 
d 

3d 

Insert, before the next character, whatever is typed 
inserting when the escape key is pressed. 

Replace n characters, i.e., delete n characters (nd) , 
insert ( i) . 

Exit alter mode (return to edit mode) . 


EXERCISES 

The left column below is a series of commands to the various 
modes of SOS. (The SOS command is, of course, given to the 

monitor.) The right column describes the results of typing t 1 : 
corresponding lines of the left column. This exercise is designed 
to help the novice gain experience in the use of SOS. 


type this: 


SOS FILEA.TST 
AAAAA 
RBBBB 
CCCCC 
DDDDD 
EEEEE 
$ 


P300 

P300: 500 
1100 
ABABAB 
D400 
ES 

SOS FILEA.TST 
P100: 500 

R200 
Z Z Z Z Z 
D300 : 400 
1300 
ABCD 
ABC-D 
1700 
FFFFF 
GGGGG 
HHHHH 
$ 


to do this: 

INPUT MODE 

Create a file with 5 lines in it. 


(Press the escape key, not the dollar sign.) 
EDIT MODE 

Print the 3rd line. 

Print lines 300 through 500. 

Insert a line after line 100. 

Delete line 400. 

Exit, stripping the line numbers off. 

Reenter SOS (edit mode) . 

Print the whole file. (Note that the line 
numbers have changed.) 

Replace line 200. 

Delete 2 lines. 

Insert new lines 300 and 400. 


Insert lines 700,800,. . . 

Note that if there is room for the insertion of 
another line (incrementing by 100), then SOS 
will insert another line. 

(Press the escape key, not dollar sign.) 


next . 

then 
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R100 

123451234512345 

AlOO 


<space><space> 

<bksp> 

1 

2s3 

cO 

d 

si 

iOOO$ 

<cr> 

PlOO : 900 
E 


Replace line 100 with some numbers. 

Enter alter mode for line 100. 

ALTER MODE - Note that commands do not print. 

Move to the 3rd character of the line. 

Move back to the 2nd character. 

(the letter 1) Print out the line. 

Return the pointer to the start of the line. 

Skip to the 2nd 3 of the line. 

Change it to a zero. 

Delete the next character, 
skip to the next 1. 

insert 3 zeroes before the 1. (End the insertion 
by pressing the escape key.) 

End alter mode, return to edit mode. 

Print the entire file. 

Leave SOS. 


PART 2 


CHAPTER I - BACKUP FILES AND EXITING SOS 


When SOS is called upon to edit a file, SOS makes a copy of the 
file. All of the editing that you ask SOS to do is done on the 
copy. The copy (the edited file) does not exist in your storage 
area until you ask SOS to store it. When you give the E or ES 

commands, SOS changes the name of the original file (by putting a Q 

in its extension). Then it stores the edited version with the 
original filename. 

By leaving the original file stored and working on a copy, SOS 
has a "backup" file, a file you can go back to if anything goes 
wrong. There are several variations of the E command which allow 
manipulation of these two files. 

E< 2 means, "Exit to the monitor and forget any editing 

that I have done," i.e., leave the file as it was 

before the SOS command was given. (Quit while you're 
ahead.) To prevent catastrophes, SOS will ask, 
"Really?" making sure there is no mistake. If you 
then respond with anything but "Y" or "YES," SOS will 
return to edit mode (giving an * prompt) . NOTE: If 
you give the EQ, YES combination for a file you are 
creating, the file will cease to exist, since you 
never stored it. 

EB is like the E command, except that no backup file is 

created. Only the edited version exists after 
returning to the monitor. 
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E: <f ilename> This command allows you to make the name of th 

edited file different from the original. The 
unedited version keeps its name; the filename given 
in the command is used for the edited version. 

E : FILE2? . FOR 

E : SAMPLE . DAT 

ED Asks SOS to delete the file entirely, i.e. after this 

command is processed, the file being worked on will 
no longer exist. 

"C (Control-C) This is another way to exit from SOS. 

SOS will respond by typing "YES? (type H for help);", 
asking you to choose one of six options; 

C - — continue (cancel ~C request) . 

E - — -like E in edit mode. 

EQ like EQ in edit mode. 

M — —Return to the monitor. SOS can be restarted 
by typing CONT to the monitor. 

H -“—-type this list of options. 

R reenter edit mode. (Terminate infinite 

searches , etc . ) 


SUMMARY OF EXIT COMMANDS 




E 

exit. 

store the edited file. 

ES 

exit. 

but remove line numbers. 

E : <£ ilename> 

exit, 

but change filename. 

EQ 

quit. 

do not store edited file. 

EB 

exit, 

but no backup file. 

ED 

delete 

: the file and return to the monitor . 


problem exit. 


CHAPTER II - POINTER MOVEMENT AND LINE REFERENCES 


SOS continually maintains a pointer, an indication of which 
line was last referenced. A period (.) may be used to indicate this 
current line, i.e., you may print the current line by giving th^ 
edit mode command "P." This pointer is moved whenever a command 
refers to. a different line, i.e., P120G moves the pointer to line 
1200. Another way to move the pointer is with the point command. 
The command consists of a period, followed by a line number. The 
pointer is moved to the line indicated, i.e., the command ".2700" 
moves the pointer to line 2700. 

You can also reference lines near the pointer by using the 
formats ,-n or .+n to indicate the nth line before or after the 
current one {.+1 is the next line; .-10 is the tenth line before the 
current one) . Probably the most common commands are P.+l and P.-l, 
so SOS has special forms to simplify these commands. Pressing the 
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line feed key (or control-J instead) prints the next line 
(equivalent to P.+l); pressing the escape key when in edit mode 
prints the previous line (equivalent to P.-l) . Two other commonly 
referenced lines are the first and the last lines of the file. Just 
as the period refers to the current line, an up-arrow (") means the 
first line, and an asterisk (*) indicates the last. You can also 
refer to lines by ~+n or *-n. 

Now you can refer to lines of a file in several ways. You can 
use the line number or one of . optionally with a or ~n. You 
can refer to a range of lines by using the format <line> : <line> , 
where the colon separates two line specifications. One more way to 
describe a range of lines is to indicate a number of lines beginning 
with a particular line by using the format ClineMn. 


EXAMPLES: 


P. 15 

p~ ; * 

P.-2 : + .2 

D. 

D*-l 

D~13 


Print this line and the next four. 

Print the entire file (Page 1 of a paged 
Print 5 lines beginning 2 before current 
Delete the current line. 

Delete the next to last line. 

Delete the first three lines. 


file) . 
line. 


SOS simplifies looking at segments of a file with a special 
form of the print command. The print command with no arguments 
(i.e., "P") prints the current line and the next 15 (i.e., 

equivalent to "P.116"). 


If you wish to print lines without their line number, we can 
use any form of the print command with the S option. This option is 
obtained by adding " ,S" to the end of the command. For instance, 
you can say P100:900,S or P350!15,S or P,S. NOTE: After this 
command, the asterisk may not print out. Push <cr> to get it. 


You may want to move the pointer to the line where a particular 
word or phrase is. The find command (F) accomplishes this. Th ^ 
format is F<str ing>$<range> , where<str ing> is the word or phrase to 
be found, followed by the escape character, followed by the range of 
lines to be searched. The command instructs SOS to search for the 
word or phrase indicated, to print the first line where it occurs, 
and to move the pointer there. If no occurrence is found, SOS types 
"% SEARCH FAILS." For example, FWIRE$100 : 1 500 means find the first 
occurrence of the word "WIRE" in lines 100 through 1500. 


Omitting the range from the F command causes the search to 
cover from the current line until the end of the file, i.e., <range> 
is assumed to be If no arguments are given, SOS will search 
for the next occurrence of the same <string> as used In the last F 
command . 


The find command also allows multiple search strings. If you 
wish to search for two strings, include both strings, separated by a 
carriage return. (The second string is ended by pressing the escape 
key). This format of the command searches for the first occurrence 
of one string or the other . 
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The find command also has several options available. Each 
option is obtained by following your command with a comma and the 
appropriate letter (or number), e.g. FABC$~:*,A. The following are 
the available options: 

A Enter alter mode when the line is found, position the pointer 
immediately before the string that was found. 

D Decide mode. After finding a line, SOS will type out "D*", 
allowing you to then choose the next action to" be taken. 
Responses include <space> (meaning "OK, continue searching", if 
the, n option below was used); G (meaning "OK, but no more 
searching"). The other responses are A,I,K,M,R,X with the 
meanings described in this list. 

E Find an exact match of the string being sought. Normally SOS 
does not differentiate between upper and lower case letters. 
With this option SOS will not find a match unless it is an 
exact match. 

I Insert a line immediately following the line found. 

K Delete the line found. 

M Insert a page mark immediately before the line found. 

N Only type back the line number of the line found, 

n (where n is a number) find n lines containing the string. 

R Replace the line found. 

X Extend the line found, i.e. add to the end of the line. 


SUMMARY OF POINTER MOVEMENT COMMANDS 


. <line> 

F<str ing>$<range> 

F<str ingXcrXstr ing>$<range> 
Cline feed> 
escape 
P 


Move the pointer. 

Find the string and move pointer. 
Find one string or the other. 
Print the next line (P.+l). 

Print the previous line (P.-l) . 
Print 16 lines (P.116). 


CHAPTER III - INSERTION 


The insertion of lines in SOS can be a tricky business, but it 
helps to keep these rules in mind: 

If the line number indicated does not exist, SOS will insert a 
line with the number given. 

If the line number indicated does exist, SOS will insert a line 
between that line and the next line. 


2 . 



TX2 


- il 


TX2 


3. If SOS can insert a second (, third,...) line while incrementing 
by 100 (or current increment, see below) , it will continue 
inserting until another line will not fit. This can occur if 
several lines were previously deleted near the insertion point. 

4. If an insert command is given for the end of the file (i* or 
equivalent), SOS enters input mode, i.e. continues inserting 
until the escape key is pressed. 

NOTE: These rules apply to the replace command as well. 

There are several special formats of the insert command: 

Kline> ,* <increment> Insert some lines incrementing by the value 

given instead of by 100. 

11200; 25 
1300 ; 5 

Kline> , <increment> Like above but the new increment is 

permanent, i.e. , use the new increment 
value in any subsequent insert commands. 

1700,10 

11500,200 

I<line>;!n Insert n lines at position indicated. SOS 

will calculate an appropriate increment. 

12650; ! 7 
1100; >20 


I/n Insert a page mark at the end of page n and 

do an 1100 for a new page. This command 
simplifies the insertion of pages, each 
beginning with line number 100. (See 
Chapter VIII) 

1/13 

1/2 

I If no line number is given, SOS will use 

the last number used, i.e. SOS will insert 
a line immediately following the most 
recently inserted line. 


I* 


Since * indicates the last line of a file, 
I* means insert after the last line, i.e. 
add lines to the end of the file. 
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SUMMARY OF INSERT COMMAND FORMATS 


Kline> 
I<line> ; n 
I < line> , n 
I<line> ; ! n 
I/n 
I 

I* 


Insert at or after the line indicated. 

Insert with temporary increment n. 

Insert with permanent increment n. 

Insert n lines after <line>, compute increment. 
Insert a new page immediately after page n. 
Insert after most recently inserted line. 

Insert at the end of the file. 


CHAPTER IV - SUBSTITUTION 


Rather than replacing an entire line or getting into alter mode 
to correct the line, the correction can be done by substitution. 
The substitute command allows you to specify a string of characters 
that are in error and the string that is correct, then have SOS do 
the work: 


s<old-string>$<new-string>$<range> 

where $ represents the escape character. Every occurrence of the 
old string in the range indicated is replaced by the new string. 

For instance, sIN$AT$1 00 : 300 specifies that every occurrence of the 
character combination "IN" in lines 100 through 300 is to be 
replaced with "AT". You must always take care to give a specific 
enough <old-string> so that no unwanted- substitutions are made. In 
the example given, each word IN is replaced by AT. However, words 
like LIME and COPYING (if present) would also be changed (to LATE 
and COPYATG ) . 

The substitute command allows multiple substitutions in one 
command. Several Cold- str ing> ' s and the same number of Cnew- 
string) ' s can be included in the command, each terminated by a 
carriage return except that each group (new and old) is terminated 
by the escape characters. In this case, SOS will substitute the 
first new string for each occurrence of the first old string, the 
second new string for each occurrence of the second old string, and 
so on. For example: SWERE<cr>WAS$ARE<cr> IS$100:500 

With all these various formats, it is easy to goof while typing 
a substitute command. Since this command includes the escape 
character , we need a special way of cancelling a fouled up command 
and that is to type two control-G’s (producing two "bells"). 

There are also several options for the substitute command. 
These options are used by ending the command with a comma and a 
letter. SOS normally does not differentiate between upper and lower 
case characters. The ,E option asks for an exact match of upper and 
lower case. If ,N is used, SOS will only type out the line numbers 
of lines that are changed. There is also a decide option (,D), 
This option says that you wish to confirm each substitution before 



I- is actually changed. When a substitution is made 
glinted out with the change, then SOS types D 
waits for a response. Allowed responses are: 


the line is 

as a prompt and 


meaning cancel this substitution (continue searching 
the other lines in the range _ 

meaning allow this substitution (continue searching) . 
meaning allow this substitution (no more . searching , 
cancel the substitution and return <.0 edit mode, 
enter alter mode for the line (continue searching). 


Nummary of substitute command formats 

s<old str ing>$<new str ing>$<r ange> 
s<o!d string-l> 

<old string-2> 

<old str ing-3>$<new string-l> 

<new string-2> 

<new str ing-3>$<range> 
s<old str ing>$<new s tr ing>$<range> , N 
s<old str ing> $<new str ing>$<range> ,D 
s i old str ing>$<new str ing>$<range> ,E 


substitute new-1 for old~l, 
substitute new-1 for old-1, 
new- 2 for old-2,... 


only type out line numbers 
confirm every substitution 
substitute only for exact 

match 


CHAPTER V - COPYING LINES 


Xf a group of lines are found to be in the wrong place m your 
t- j.1- or if a group of lines are repeated in the file (or in another 
■lie), then you need to use one of SOS's copy operations. There are 
w>1 ree similar but distinct types of copy operations m SOS; 
t-an? p er a range of lines from one point in a file to another point? 
-^plicate a range of lines from a different point in the file: 
sulicate a range of lines from a different file. 


T < d e s t i n a t i o r i > , < r a n g e > 


C<des tination> , <range> 


C<destinafcion>=<f ilespec> , <range> 


Place a copy of the lines 
indicated at or after the 
destination line ana delete the 
original lines. If necessary, 
SOS will compute an appropriate 
increment. 

T1800, 8500:9300 

Similar to the Transfer command, 
except that the original lines 
are not deleted. 

C1800, 8500:9300 

The lines of the file indicated 
are copied to the destination in 
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the current file. <filespec> 
represents the appropriate 
DECsystem-10 file specification. 


C1800=FILE23. DAT ,2000:3000 


If SOS cannot find an increment that will allow all the lines 
to be copied, it will copy all the lines, numbering them 
100 ,200 ,300 ,... .Then the message "incl=order" is printed indicating 
that there is a line number problem. This problem is straightened 
out by renumbering the lines (See Chapter VII). 


If you cannot remember exactly which lines you want to cop* 
i- r om a different file, SOS will allow you to look at the file before 
doing the copy. The following format: 


C<destination>=<f ilespec>/s 

allows ^ you to enter the second file in READONLY mode. READONLY 
means tnat you can print lines or enter alter mode to examine a 
line, but you cannot use any SOS command which will change the file 
(SOS prompts with "C*" to remind you). When you know which lines 
you want to copy, give the E command to return to your editing file. 
SOS will then ask "Source lines=" so that you can complete the copy 
operation. If you decide not to copy any lines while reading the 
file, type EQ to abort the copy command. 


SUMMARY OF COPY COMMANDS 


T<destination> , <range> 

C< destination^ <r ange> 

C <des t inat ion> = < f ilespec> , <r ange> 
C<destination>=<f ilespec>/S 


Transfer some lines. 

Copy some lines 

Copy from another file. 

Copy, but first examine <filespec> 
READONLY mode. 


CHAPTER VI - JOINING LINES 


, When working with text files, there are customarily times when 
a , } ine is to ° iong or too short. SOS has a pair of "join" commands 
•which help to solve this problem. One join command is in edit mode 
-' r d the other is in alter mode. 


(edit mode) Combine the line indicated with the 
following line. The second line is deleted. 


J1300 

J. 


(alter mode) Take all of the characters to the right 
of the pointer and insert them at the beginning of 
the next line, making the current line shorter and 
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the following line longer. After the command is 
executed, SOS will be in alter mode for the following 
line with the pointer at the beginning of the line. 


SUMMARY OF JOIN COMMANDS 

J<line> edit mode join. Combine two lines into one. 

j alter mode join. Join rest of line to next line. 


CHAPTER VII ~ RENUMBERING LINES 


It is sometimes desirable or necessary to renumber the lines of 
a file. For instance, if a great deal of editing has been done, 
lines have been inserted and deleted, the line numbers may no longer 
be as convenient as 100, 200, 300, ... On the other hand, some 
other regular numbering system may be desired. Either change can be 
accomplished with the Number commands: 

N<.increment> , <r ange> , <f irst line number> 

Number the lines in the range indicated. Begin numbering with 
the first line number given and increment by <increment>. If no 
arguments are given (e.g., '‘N”), SOS assumes standard line numbers 
are desired (increment = 100, first line number = 100, range is the 
entire file) . 

N 

N100, 685:862, 700 

N5 , ~ , 5 

NA<increment> , <r ange> 

Add the increment value given to each of the line numbers in 
the range indicated. This command is normally used when so much 
inserting has been done between two lines of the file that there is 
no more room for insertion. 

NA50, 2005:2100 

When numbering is done to a paged file (See Chapter VIII) , SOS 
begins each page with <first line number>, that is, the (standard) 
first lines of each page are each numbered 100. If you would rather 
have the line numbers continue incrementing over page marks, use the 
following command: 

NP<increment> , <r ange> , <f irst line number> 

Number the lines in the range indicated beginning with <first 
line number> and incrementing by < increments Do not reset to 
<first line number> at beginning of pages. i.e., keep incrementing. 
Again no argument means standard values. (See Chapter VIII for an 
explanation of the second example) . 

NP 

NP10, Vl:*/5,10 
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The normal line numbering scheme for paged f iles has the first 
line of each page labelled 100; the second of each page 200, and so 
on* If a page mark is removed, therefore, the resulting page wiix 
have two line 100’s, two line 200's, etc. SOS indicates this 
problem by stating, "%OUT OF ORDER.” The cure for this problem is 
to renumber the lines. (See Chapter VII on renumbering.) 


SUMMARY OF PAGING COMMANDS 


M<iine> 

K/<page number > 
K/<page#> :/<page#> 


Mark a new page. 

Kill the page mark. 

Kill the range of page marks. 


CHAPTER IX - CASE CHANGES 


When editing text files, you may need to work with both upper 
and lower case letters. Normally this is accomplished by giving the 
SET TTY LC monitor command before entering SOS. When doing just one 
or two changes, however, it is common to forget to give the command. 
So, SOS has some new commands to change the case of letters. There 
are three new edit mode commands and three new alter mode commands. 
These commands allow you to change lower case letters to upper case, 

to do the reverse, or to invert the case of each letter encountered. 

Note that these commands affect only the letters encountered; they 
have no effect on digits or special characters. 

In edit mode, the commands act on each letter in the range of 

lines that you specify. The command VL, followed by a range of 

lines, changes all letters to lower case. The command VU changes 
all letters to upper case. The command VV inverts the case of each 
letter. That is, any lower case letters encountered are changed to 
upper case and vice versa. 

VL10G:200 change all letters in lines 100 through 200 to lower case. 

VU700:10QG change all letters in lines 700 through 1000 to upper ca^ 

W4QQ:6Q0 invert the case of all letters in lines 400 through 600. 

In alter mode, there are three analogous commands. However, 
these commands function character by character rather than line by 
line. > is the command to change the next character (if it is a 
letter) to lower case, while < does the reverse. . Either of these 
can be preceded by a number to repeat for more than one character 
i.e. 4> means to change all the letters among the next four 
characters to lower case. If a negative number is used, the command 
functions towards the left. The invert case command is V, which 
means: if the next character is a a lower case letter, make it 

upper case and vice versa. Again a number can be used to repeat the 
command to the right (or left if negative) . For example, -7V means 
to invert the case of the previous 7 characters. 



TX2 


- 16 


TX2 


SUMMARY OP NUMBER COMMANDS 

N< increments , <range> , <f irst line number > renumber the lines in 

<r ange> . 

NA<increment> ,<range> add to each line number. 

NP<increment> , <range> ,<f irst line number> N , but increment at page 

mark . 


CHAPTER VIII - PAGING 


SOS allows you to group the lines of a file into pages. This 
ability is normally used for text files. Another reason for 
understanding paging is for editing paged files, such as those 
produced by RUNOFF, the DEC-10 text formatter. 

Each page of an SOS file can contain any number of lines, as 
you have seen from the one-page files you have been dealing with. 
When editing paged material, line numbers refer to the current page, 
unless a different page is indicated. The page is indicated by a 
slash followed by the page number. For instance, plQQ/2 says to 
print line 100 of page 2. Any subsequent commands now refer to page 
2 until another page number is given. SOS puts a "page mark" at the 
beginning of each page. The mark is only printed if it is inside 
the range of lines being printed. Note that ~ and * refer to the 
first and last lines of the current page, i.e., P~:* will print only 
the current page. Just as and "*" refer to the first, the 

current and the last lines of the page, /" refers to the first page 
of the file, /. to the current page, and /* to the last page. An 
entire paged file may be represented as s */*. If you wish to 
refer to one entire page (to print, delete, etc.), no line 
indication is needed, i.e., "P/3" will cause all of page 3 to be 
printed . 

The following commands allow you to separate material into 
pages or to "unpage" paged material: 

M<line> Insert a page mark immediately before the line 

indicated. The page number of any lines 
following the new page mark is increased by 1. 

K5100 

M6375 

K/<page number > Delete the page mark indicated. Any larger page 

numbers are decreased by 1. The page indicated 
and the one before it are merged into one page. 
You may also delete a range of page marks with 
the format: 

K/<page#> : / <page#> 

K/3 

K/4 : / 6 
K/10 
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SUMMARY OF CASE CHANGE COMMANDS 

edit mode: 

VL<range> change all letters in range to lower case. 

VU<range> change all letters in range to upper case. 

VV<range> invert the case of all letters in range. 

alter mode: 

(~)n> change all letters among the next (previous) n characters to 
lower case. 

(~)n< change all letters among the next (previous)n characters to 
upper case. 

(-)nv invert case of all letters among the next (previous)n 
characters . 


CHAPTER X - MISCELLANEOUS EDIT MODE COMMANDS 


The remaining operations of SOS edit mode are: listing lines 
on the line printer, extending lines (inserting at the end of the 
line) , and an edit-execute sequence for program files. Some 
variations of the Save World command are also described here. 

Listing . A file or a range of lines will be sent to 
the line printer by SOS if the L command is given. "L" asks that 
the entire file be listed, while "L<range>" asks for just a range of 
lines to be listed. An "S" option allows the suppression of line 
numbers for the lines listed, that is, "L,S" and "L<r ange> , S" each 
specify that a group of lines are to be listed on the line printer 
without their line numbers. 

Extending Lines . A common use of alter mode is to add to the 
end of existing lines. The sequence of commands might be A100, 
<tab>(Skip to end of the line ), then i (begin inserting). The 
extend command in edit mode (x) has the same effect as this sequence 
of commands. 

X<range> One by one, print the lines and wait for insertion at 

the end of each line. You are, at this point, in 
alter mode, so that pressing the escape key will end 
the insert and allow alter mode commands to be used. 

X1250 

X.+1110 

If you do not want the current line typed out, use the S option, 
e.g., X300,S. SOS will not type the line but merely wait for input. 

Edit-Execute . SOS is very handy for debugging a program, 
che sequence commonly being: create a program file, execute it, 
correct it, execute, correct, ... SOS simplifies this process by 
having an "execute" command in edit mode. After the first 
execution, you will probably give the monitor command "SOS". (The 
filename is remembered from the last SOS command.) After all 
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apparent corrections are made, you may give the edit mode command 
"G". Just as the execute and SOS monitor commands remember the last 
file used, the G command instructs the computer to re-execute the 
last program that was executed (probably the one you are editing). 

The command sequence (after the incorrect first execution of a 
program) could be: "SOS", then whatever editing commands are 
needed, then "G" to execute the program, repeating until the program 
works. NOTE; The G command has the same variations as the E 
command, i.e., GS , GB and G : <f ilespec> . (See Chapter I for 
description . ) 

Save World . The Save World (W) command allows you to 
store the current version of your file and to continue editing. 
This command has the same variations that the E command has, i.e., 
WS, WB and V,': <filespec> . (See Chapter I f or description.) The W 
command can be made automatic also. The SAVE option generates an 
auto-w command after the specified number of edit mode commands, 
the ISAVE option generates an auto-w command after the specified 
number of input lines. (See Chapter XI for more description.) 


SUMMARY OF MISCELLANEOUS EDIT MODE COMMANDS 

L<range> List the range of lines. 

L List the file. 

L,S List without line numbers. 

X<range> Extend the lines one by one. 

X<range>,S Extend, but do not type out lines. 

G (GS, GB, G: <filespec> ) Go and execute. 

W (WS, WB, W : <f ilespec> ) Save world. 


CHAPTER XI - MISCELLANEOUS ALTER MODE COMMANDS 


In Part 1 of this manual, alter mode commands were classified 
as three types: pointer positioning, action and finishing commands. 
Here we introduce five more positioning commands, four more action 
commands, and three more finishing commands. 

Each previously described pointer positioning command has 
another similar command. 

n<space> Move the pointer n spaces forward (right). 

n<bksp> Move the pointer n spaces backward (left). 


p Type out the line, then return the pointer to the 

current position. 
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nw ski P forward n words. The pointer, after execution 

will he at the first character of the nth word after 
the current word , 

ctab> Pressing the tab key causes the pointer to move to 

the end of the line. If a minus sign is typed first, 
the pointer moves to the start of the line. 

Two of the action commands presented here are alternative 
methods for replacing and deleting information in the line. Another 
is a variation, of the insert command. 

T Replace one word. This command deletes the spaces to 

the right of the word, so you may want to reinsert 
them. 


nkCcharacter > Delete, all of the characters up to, hut not 

including, the nth occurrence of "the character. 
-nk<character> will delete to the left of the 

pointer. If there is no occurrence, the pointer will 
not be moved. 


kc (delete until the first c) 

3kt (delete until the third t) 

“5k0 (delete backwards until the fifth 0) 

Delete n words. More precisely, delete from the 
pointer to and through the nth group of one or more 
spaces. 


Extend the line, i.e. move the pointer to the end of 
the line and initiate an insert. If this command is 
preceded by a minus sign, SOS will type out the line 
number and initiate an insert at the beginning of the 
line. 


Mote that 
specified, 
these allows 


nine alter mode commands allow a negative n value to be 
The nine are D, K, R, S, V, X, <tab>, < and >. Each of 
correction to the left of the pointer. 


. S ? S has a special feature which allows you to insert a new line 
w . le in alter mode. If a Cline feed> is entered (by pressing the 
ke Y or Control-J) as part of text for the insert comma*'!, 
bOS will generate a new line number (by incrementing or computinc 
one if necessary}. Any additional text will be inserted into the 
new line. New lines rnay.be continually entered until the escape key 
.is pressed or there is no more room for a new line number. A 
special form of the alter mode insert commands allows you to specify 
‘-he increment for the new lines: ’ 


Insert text; ended by pressing the escape key. If any new 
lines are started using the line feed key, use n for the line 
number increment. 


ni 
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Three additional finishing commands: 

Leave alter mode, but do not print the remainder of the line. 
Quit, leave alter mode, but undo any corrections made. 

Cancel any corrections just made, but begin the alter again. 


SUMMARY OF ALTER MODE COMMANDS 


n<space> 

1 

(-) ns<character> 
(-) <tab> 
nc<str ing> 
ni<str ing>$ 
(-)nk<character> 
<cr> 

q 

n<bksp> 

P 

nw 

nu 

(-)nd 

(-) nr <str ing>$ 
t 

(-) n> 

(-) n< 

(-) nv 

(-)x 

e 

u 


Move pointer right. 

Print pointer to start. 

Skip to nth occurrence. 

Skip to end/ start of line. 

Change n character 
Insert (increment n) . 

Delete to nth occurrence. 

Leave alter mode. 

Quit, undo corrections. 

Move pointer left. 

Print, pointer same. 

Skip n words. 

Delete n words. 

Delete n characters 
Replace n characters. 

Replace one word. 

Change n characters to lower case. 
Change n characters to upper case. 
Invert the case of n characters. 
Extend the line. 

Leave without printing. 

Quit and begin again. 


CHAPTER XII - SWITCHES AND PARAMETERS 

SOS has a series of options available. Each of the options may 
be set as a switch in the "SOS" command. To use a switch, follow 
the filename with a slash and then the option name, e.g., "SOS 
FILE27 . DAT/EXPERT. " More than • one switch may be used _ in one 
command. The options may alternatively be setwhile in edit mode. 
In edit mode the format is to type the underline character (_) , 
followed by the option name. (On ADDS terminals, the left arrow is 

used.) 

There are several options which are set to a value instead of 
on or off. These are set by following the option name with a colon 
and the value desired (e.g., increment: 10) . 

OPTIONS : 

BAK Create a backup file, i.e., store the _ unedited 

version of th is file in a file whose extension begins 
with a Q. This option is the default. 
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BASIC 

BLOCK 

C64 

C128 

COMPRESS 

DECIDE 

DELETE 

EXACT 

EXPERT 


INCREMENT :n 

I SAVE : n 

LOWER 


The file was written with BASIC (the format of line 
numbers is different). This is assumed for a file 
whose extension is .BAS. 

Create a line-blocked file. This is the default. 

64 character set. 

128 character set. 


Remove form feeds , etc from text to get a 
"compressed" file. 


Confirm 
option of 
Chapters 
default i 


any substitution made. Equivalent to the ,D 
the substitute and find commands. (See 
II and IV for more explanation.) The 
s NODECIDE , 


Delete the file upon exit from SOS. To prevent 
tragedies, SOS will ask "Do you really want to delete 
the file (Y or N)?' ! before proceeding. 

Normally SOS does not differentiate between upper and 
lower case when doing string searches, i.e. the find 
command for the string THE will "find" The, the, etc. 
If the EXACT option is turned on, however, SOS will 
only find an exact match of upper and lower case. 

This option causes certain things not to be typed 
while using SOS. When characters are deleted or 
replaced in alter mode, they will not be typed out 
surrounded by slashes as usual. This allows the line 
to appear as it actually is, without deletion 
indicators. If an error occurs, just a three-letter 
abbreviation is typed instead of the entire message. 
Also no confirmation of questionable commands i.” 
asked (e.g., "Massive delete OK?"). The opposite of 
this option is NOVICE, which is the default. 

Change the line number increment to n. Default = 

100 . 


Automatically execute a Save World command (W) after 
every n lines of input. Default = 0 (never). 

Interpret all letters as lower case instead of upper 
case. This option does not give both upper and lower 
case; only the "SET TTY LC" monitor command 
accomplishes that. 

Change the name of the edited file to the name given. 
The backup file keeps its original name. Using this 
option has the same effect as the E: filename command 
(Chapter I ) . 


NAME ; newname 
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NOBAK 

NOBLOCK 

NOCOMPRESS 

NODECIDE 

NODELETE 

NOEXACT 

NONUMBERS 

NOVICE 

NUMBERS 

OLD 


OPTION : opti 


PLINES ; n 


Do not create a backup file. The only file will be 
the edited version. Using this option has the same 
effect as the EB command (Chapter I). 

Turn off Block. 

Turn off COMPRESS. This is the default. 

Turn off DECIDE. This is the default. 

Turn off DELETE. This is the default. 

Turn off EXACT. This is the default. 

Do not print line numbers. The lines are numbered as 
always, but the numbers are not printed. The default 
is NUMBERS. 

Turn off EXPERT. This is the default. 

Turn off NONUMBERS. This is the default. 

This option will cause SOS to store your unedited 
file with a different extension than the normal 

backup file (by replacing the first letter of the 

extension with a Z) . If you do a lot of editing, you 

can store your original file as a Z file, then your 
normal backup file (Q in extension) is an 
intermediate version. The Z file remains as the 

or ig inal . 

-name If you have several favorite switches, they may 

be made defaults (for you) by creating a file 

named SWITCH.INI with a line in it of the 

following format: 

SOS/Switch/Switch. . . 

If you have an alternative favorite set of 

switches, enter a line into SWITCH.INI with the 
following format: 

SOS : opt ion-name/Sw itch/ Switch . . . 

Nov; when you enter SOS, you will get your 
default switches. When you use the OPTION 
Switch, however, SOS will look in SWITCH.INI for 
a matching SOS : option-name line and use those 
switches instead. 

The print command with no arguments (i.e., ’’p' 1 ) is 
normally equivalent to p.116 (print 16 lines). The 
number of' lines printed is changed to n by this 
option. Default = 16. 
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READONLY Enter readonly file. In this mode, any command which 

(or RONLY) would alter the file is illegal. This option cannot 

(or R) be turned off while in SOS. Default is off. 

RUN : program-name Normally, when an edit mode G command is given, the 
COMPILE system program is run after exiting from SOS. 
With the" RUN option, you can specify a dif f * ~ 4 - 
system program to be run, e.g. RUN:RUNOFF. 

Automatically execute a Save World command (W) after 
every n edit mode commands. Default=Q (never ) . 

Turn off UNSEQUENCE. This is the default. 

Change the first line number to n. Default = 100. 


SAVE : n 

SEQUENCE 
START :n 


STEP:n Set increment to n. Default = 100. 

UNSEQUENCE Remove line numbers when the file is stored. This 

option has the same effect as the ES command (Chapter 

I) o 


UPPER 


Turn off LOWER. This is the default. 


SOS will answer several questions about your job’s status. 
These questions are "asked" while in edit mode by typing an equa^o 
sign, followed by the "question," e.g., =ERROR. 


=BAK 

=BIG 

=BLOCK 

=CASE 

=COLUMN 

=DECIDE 

=DELETE 

=DISK (or =DSK) 
=ERROR 

=EXACT 

=INCREMENT 

=ISAVE 

=LOCATION 

=NAME 

SPLINES 

=RUN 

=SAVE 

=SEQUENCE 

= START 

=STEP 

^STRING 


What is the current pointer location? 

Is the BAK option on or off? 

How many pages in this file? 

Is the block option on or off? 

What case is SOS in? 

Type out numbers to label columns, simplifying 
the lining up of text. 

Is the DECIDE option on or off? 

Will the file be deleted upon exit? 

What is the current storage quota information? 
What was the last error message given? (prin'. 
the full message even when in EXPERT mode) . 

Is the EXACT option on or off? 

What is the current increment value? 

What is the current ISAVE value? 

What is the first location in the edit buffer? 
What will the name of this file be when stored? 
What is the current PLINES value? 

Which system program will be after a G command 
What is" the current SAVE value? 

Is the SEQUENCE option on or off? 

What is the current START value? 

What is the current STEP value? 

What are the most recently used strings in the 
find and substitute commands? 
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Several of the items surrounded by angle brackets merely mean 
to press a particular key on the terminal keyboard: 

<cr > carrier return (RETURN key or NEWLINE key) . 

<tab> tab key. 

<space> the space bar. 

<bksp> the backspace key. 

<iinefeed> the linefeed key (also CONTROL J) . 

<delete> the DELETE key. 


The other items are to be replaced with whatever is described: 

<line number> an SOS line number. 

<page number > an SOS page number. 

<increment> the number to add to a line number to get 

the number for the next line. 

<lst line number > the line number used for the first line of 

the file or the first line of each page. 

In the Number commands, the line number for 
the first line being renumbered. 

<string> any combination of zero or more characters, 

usually ended by pressing the escape key. 

<filespec> any valid DECsystem-10 filename and 

extension. 

<character> any valid ASCII character. 

<destination> any line indication telling where to place 

copied or transferred information. 

<line> a line indicator. Any of: 

1. a line number. 

2. . (the current line symbol) or . +n or .-n. 

3. * (symbol for last line) or *-n. 

4. (symbol for first line) or /v +n. 

indication of a line or a group of lines. 

Any of: 

1. a line indicator (See <line>). 

2. <line> : <1 ine> . 

3. <line> In. 


<r ange> 
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APPENDIX B 


SWITCHES AND PARAMETERS 


(For further description, refer to Chapter XII.) 


BAR 

BASIC 

BLOCK 

C64 

C128 

COMPRESS 

DECIDE 

DELETE 

EXACT 

EXPERT 

INCREMENT :n 

ISAVE:n 

LOWER 

NAMErnewname 

NOBAK 

NOBLOCK 

NOCOMPRESS 

NODECIDE 

NODELETE 

NOEXACT 

NONUMBER" 

NOVICE 

NUMBERS 

OLD 


Create a backup file. 

File is in BASIC format. 

Line- block the output file. 

64 character set. 

128 character set. 

COMPRESS the output file. 

Confirm any substitution. 

Delete file on exit. 

EXACT match of upper, lower case. 
Work in expert mode. 

Change line increment to n. 

Auto-w on input. 

Every letter in lower case. 

Rename the edited file. 

No backup file. 

Turn off line blocking. 


Do not COMPRESS output file. 

No confirmation of substitution. 

Turn off DELETE option. 

Don't differentiate upper, lower case. 

Don't type out line numbers. 

Return to NOVICE mode. 

Begin typing line numbers again. 

Create Z backup file. 

OPTION : option-name Get set of Switches from SWITCH.INI 
PLINES:n Change number of lines for "p<cr>". 

/R READONLY mode. Can only be a switch in SOS command . 

/RGNLY or /READONLY " " " " 

RUN : program-name Run program after G command . 

SAVEtn Auto-w in edit mode. 

SEQUENCE Stor’e with line numbers. 

START : n Set first line number. 

STEP:n Set line number increment. 

UNSEQUENCE Store without line numbers. 

UPPER Every letter in upper case. 


EDIT MODE 


“BAK 

-BIG 

=BLOCK 

“CASS 

=COLUMN 

“DECIDE 

“DELETE 

=DISK or =D3K 

“ERROR 

“EXACT 

“INCREMENT 

=ISAVE 

=LOCATION 

--NAME 

“PLINES 

-RUN 

=SAVE 

“SEQUENCE 

“START 

“STEP 

“STRING 


"QUESTIONS" 

What is current line number? 

Is BAK option on or off? ' 

How many pages in file? 

Is BLOCK option on or off? 

Give case information. 

Type out column numbering. 

Is DECIDE option on or off? 

Is the DELETE option on or off? 

What is current storage quota information? 

What was most recent error message? 

Is EXACT option on or off? 

What is current increment? 

What is current I SAVE value? 

What is 1st location in edit buffer? 

What will filename be? 

What is current PLINES value? 

What system program will a G Command run? 

What is current SAVE value? 

Is SEQUENCE option on or off? 

What is first line number? 

What is current increment? 

What were the most recently used strings for the find 
and the substitute commands? 
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APPENDIX C 

EDIT MODE COMMANDS 

Refer to Page: 


. <line> Move pointer. 8 

A<range> Enter intraline edit mode for 

lines, one by one. 5 

C<destination> , <r ange> Copy range of lines to 

destination. 13 

C<destination>=<f ilespec> ,<range> Copy from another file. 13 

D<range> Delete lines 4 

E End, save the file, return 

to the monitor. 5 

EB E, but don't save a Backup 

file. 7 

EQ E, but don't store new 

(edited) file; Quit. 7 

ES E, but strip line numbers. 5 

FCstr ing>$ <range> Find string and move pointer 

there. 9,10 

G Go, execute last file executed. 18 

I<line> Insert a line or lines. 4,10,11 

J<line> Join this line and the 

following line. 14 

K/<page number> Kill the page mark indicated. 16 

L<range> List (on LPT) the lines 

indicated. 18 

M<line> Put a page mark before the 

line indicated. 16 

N<increment> ,<range> ,<start> Renumber using the values 

given. 15 

NA<increment> , <range> Add increment to each line 

number. 15 

NP< incr ement> , <r ange> , <s tar t> N, but don't restart 

numbers at new page. 15 

P<range> Print lines. 4,8,9,16,23 

R<range> Replace lines. 4,11 

SCold string>$<new str ing>$<range> Substitute new string for 

old. 4,12,13 

T<destination> , <r ange> Transfer lines to destination. 13 

7L Change letters to lower case 17,18 

VU Change letters to upper case 17,18 

VV Invert case of letters 17,18 

W Save World, continue 

editing. 5,19,22,24 


Extend, add at end of each line. 18 


XCr ange> 
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n<space> 

(-) <tab> 
n<bksp> 

1 

P 

(-) nsCchar acter > 

nw 

nc<str ing> 

(-)nd 

(-) nkCcharacter > 

i<str ing>$ 

(-) nr <str ing>$ 

nu 

t<str ing>$ 

j 

(-)x 
'-) n> 

(-) n< 

(-)nv 

<cr> 

q 

e 

✓\ 

u 


APPENDIX D 
ALTER MODE COMMANDS 

Refer 

Move pointer n characters right. 

Move pointer to end (start) of line. 

Move pointer n characters left. 

Print rest of line; place pointer at 
beg inning . 

Print rest of line; place pointer at 
current position. 

Skip to the nth occurrence of 
<char acter> . 

Skip forward one word. 

Change n characters to those 
indicated . 

Delete n characters. 

Delete to the nth occurrence of 
<character> . 

Insert the string (end with escape). 

Replace n characters (end with 
escape) . 

Delete n words. 

Replace one word (end with escspe) . 

Stick remainder of line at start of 
next . 

Extend, insert at end (Start) of line. 
Change n characters to lower case. 
Change n characters to upper case. 
Invert case of n characters. 

Exit from alter mode. 

Quit, cancel any editing. 

Exit, but don’t print rest of line.. 

Quit and start again. 


to Page: 
5, 19 
20 

5, 19 

5 

19 

5, 20 

20 

5 

6 , 20 

20 

6 , 20 

6 , 20 
20 
20 

14 

20 

17 

17 

17 

6 

21 

21 


21 




TO USE THIS .DISPLAY TERMINAL TO LIST THE QUEUE 


1 ) Sign on us i n g y o u r B A T C H A c c t * n u m b e r * 1 o d o t h i s * 

) 0 N n n n ri ri n n n t p 8 s s w o r d 

Where nnrinnnnn is your BATCH Account Number? arid pss 
i s y o u r B A T C H p a s s w o rd + 

2 > To 1 i a t t h e a u e u e t y p e t h e d i s p 1 s y c o m m s n d 

DQ15J 

exactly as it appears here* This will display the c 
one page at a time* To get a new page hit enter* 

3 ) A f t e r y o u h a v e f i n i s h e d 1 i s t i. n g t h e c u e u e ? y o u mu s t 

cTT . T -• thi'* - • Birl « t yr c 

) OFF 

If you have any trouble entering commands ? hit the RESE1 
on the display terminal* 


t y p e t 

j a word 

sue ue 
s i g i"i 

” butt 




■ . 


DEC'S YSTEH-10 STORAGE QUOTAS 


When «ou store files on the BECsystem-10? the monitor records the 
size of each file for you > The size is measured using a unit coiled a 
"disk block* (or simply block) ? which is eou3l to 640 characters of 
information* When you ask for your directory (using the "DIRECTORY" 
monitor command) ? each file is listed like the following* 

PR061 FOR 2 <057> 19-0CT-76 

The 2 which appears in this example is the number of blocks needed to 
store the file PROGt *F0R* 

When the DECsystem-10 stores a file* however* it sets aside (i.e* 
"allocates®) a certain amount of storage? normally 5 blocks* If this 
allocation is used up* another 5 blocks are allocated* When the file is 
totally stored? the total number of blocks allocated will be a multiple 
of 5 and may not be entirely filled (NOTE! 2 blocks are used for system 
information* and* if necessary another 5 blocks allocated)* The monitor 
also records the total allocated size of each file* 

Each user is assigned 2 Quotas on the amount of storage that can be 
allocated* You are allowed to store a great deal more information when 
you are logged-in than you may store after you have logged-out? i*e* 
your logged-in Quota is larder than your logged-out Quota* This fact 
can create a problem when you try to sign off* A message similar to the 
following will sometimes be typed when you attempt to “KJOB"? 

?DSKA Logged out Quota 100 exceeded by 5 blocks 

The important point to note is that your logged-out Quota is in terms of 
the storage allocated? not the number of blocks actually written* 

When this message occurs? you must delete enough files so that you 
are at or below your logged-out euota. This can be done by responding 
"I" to Confirm* ♦ As the computer types out each entry in your 
directory? respond with "K“ to delete the file? *S* to save it or "H" 
for help* The files one should normally eliminate are those with the 
following extensions? *Q'r? (an extension beginning with Q indicates an 
SOS backup file)? *BAK (another type of backup file)? *REL (compiled 
programs can be easily recompiled) and *TMP (temporary files). 

To check your allocated storage? give the monitor command 
0 DIRECTORY/ALLOC 3 * When your directory is typed out? the number of 
blocks allocated will be typed in place of the number of blocks used* 

T o check your Quotas? give the monitor command “R QUOLST"* The 
response will consist of 4 numbers? the total number of blocks 
allocated for your storage? the number of unused blocks in your 
logged-in Quota* the number of unused clocks in your logged-out Quota 
and the number of unused blocks on the system* 

If your Job remains Inactive for more than one hour for any reason? 
the system may attempt to log your Job off* If you are also over your 
logged— out Quota? the system will delete your files one by one until 
below the Quota . The order of deletion is the files with extension 
♦IMP? then *REL? then + BAK* then *SAV* If still more must be deleted? 
the oldest file (earliest creation date) is deleted first* 







Procedure for DECsystem-10 Communications Problems 


When problems develop in the Syracuse University Timesharing System* 
the associations between your terminal and the work you were doing may 
be broken* Eielow are listed the four major indicators of such problems* 

In order to re-establish contact with the system? find the response you 
are Setting (which may be no response) * and then follow the appropriate 
directions* If you have Questions* call the AID Office <x3424>. 

NO RESPONSE If you set no response to the commands that you type* 

FIRST of all try typing control-C twice* If you still Set 
no response* press the RETURN key periodically until you 
Set the sign-on message* “Syracuse University Timesharing* ♦ 
Normally? you should get, this greeting within 5 minutes of 
losing terminal response* Call the AID Office (x3424) or 
the Dispatcher <x3245> if you have Questions* When you get 
the sign-on message* follow the PROCEDURE below* If you 
get no response for 10 minutes* try again later* 

' ? DECSYSTEM~I0 NOT AVAILABLE If you get this message? try to login in 

about 5 to 10 minutes? following tne PROCEDURE below* 

?L0(3IN— t* you this response to a command when you are already Jogged 

in* then follow the PROCEDURE below* 

* v,n 3 REPEATEDLY TYPED BACK SURROUNDED BY QUESTION MARKS If you 

believe that the commands are valid* type the command DSK* 
If you get the message “?Login“? follow the PROCEDURE 
below* If you get your disk usage information typed out* 
sign off (type K/F>* then check with the AID Office <R‘oom 
116 Machinery Hall) or with your instructor to find out 
what the problem is* Take the print-out of the problem 
along* it can help in locating a problem* 


■-R0CEDURE TO FOLLOW? 

(1) Type LOGIN followed by your account number* e*g* LOGIN 14*11* 

(2) You maw get the following message? 

CLONDJS Detached Jobs same PPNZi 

If not* continue logging in normally and neglect the rest of this 
procedure* If you do get the message* you will also be asked if you 
wish to attach to the detached Job (the one you were using before 
problems developed)* Respond YES and continue to the next step* 

(3) You will be asked for your password - fy»e it in as usual. 

(4) Type a control-C. 

(5) If you had any special terminal characteristics set (for example* 
SET TTY LC>* reset them now* 

Type CONTINUE* You should now be back where you were when the 
, . ablems developed* Note that you may have lost the last line you 
typed before the problem. 



T I M E S H A R I N G 1 6 ♦ 2 6 , 5 0 T U E 06/ :l. 7 / 8 0 0 1 M 5 1 X 

/LOG 

LOG 

JOB 34 SYRACUSE UNIVERSITY 60 3 A TTY 6 
#45.4 y 12 
Password 5 

, D I E/F 

C H 2 R A B ♦ D A T D S K B 5 C 454* :l 2 ~.\ 

1-120 * BAT 
EQL :l CN * MCH 
EQL..OCN ♦ MCH 
EGNL.CN * MCH 
01 OLOC . MCH 
010NLC.MCH 
01 1 L..OC * MCH 
Oil NEC, MCH 
0.1. 2L0C * MCH 
012NL.C ♦ MCH 

01 1.. .0CN » MCH 
01NLCN.MCH 
02L0CN <• MCH 
02NI...CN * MCH 
03L0CN o MCH 
03NLCN ♦ MCH 

041.. .0CN , MCH 
04NL..CN <■ MCH 
05L.1CN. MCH 
05NL.CN ♦ MCH 

061.. 0CN . MCH 
06NL.CN .MCH 
07L0CN . MCH 
07NL.CN * MCH 
08L.0CN ♦ MCH 
08NL.CN . MCH 

091.. .0CN . MCH 
09NL.CN . MCH 
CNDDAT . MCH 
XPRDT . DAT 
CNDO ♦ FOR 
CNDDAT . NPD 


V1NLGN.NPD 
V1L0CN.NPD 
XPRDT . FOR 
D I S l :: ' I... A , FOR 
I R CD. FOR 
00 A , IMP 
ABSORP , FOR 


, Q U E 0 N D 0 ♦ F 0 R / N A M E t « j o y h S E N D " 

c; |... 1 =' T * C N D 0 ™ / S e Q 1 1 2 A 9 / 1... i in :i. t i 1 6 5 ? :l. F :i. 1 e "I 

♦ Q U E D 1 3 P I... A , F 0 R / N A M E ? " T 0 U N S E N D " 

[: L. P I J D I S P L A = / 3 e <a i 1 2 5 0 / L i m i t S 5 2 ? .1. F : ' :i. I e 1 

♦ K/F 

Job 34 User PRASAD PL C 454 » 123 
Logged-off TTY 6 at 16 J 29? 06 on 17- Jun-80 
Runtimes 0 ? 00 ? 00 v KCS? 5 ? Connect time? 0.02.35 
Disk Reads i 73? Writes? 3? Blocks saved? 666 

C h a r d e S 1 0 <■ i 2 :::: $ 0 <■ 0 5 ( R ) f -l> 0 ? 0 .1. ( K ) T 6 0 v 0 6 f > C ) 

Y e a t T o D a t e A c c o u n t U s a d e l 6 3 % 

099) SU TIMESHARING 16 .29. 3 8 TUE 06/17/80 VI MS IX 

/LOG 

LOG 

JOB 34 SYRACUSE UNIVERSITY 603 A TTY 6 
#454 ? 1 1 
Password i 


( 16 -Jun-80 ) A new version of SPELL? the spell insi correction rrosiran,? 

is on NEW? for '"'0 

.DIR/F 

H A L 0 B :i: * N i :: ' '1" D S K B ? I." 4 5 4 ? 1 1 1 

BMAT , FOR 

HAL CAR ♦ T IN 

CART ♦ FOR 

DICB .MAT 

DICHLE.BMA 

DIC FILE ♦ CIN 

DICHLE.NCA 

DICHLE . XMA 

D ICHLE.ZMA 

DICX.MAT 

FCLBR . BBB 

FCLBR * FFF 

FCLBR ♦ XXX 

FCLBR ,ZZZ 

FZMAT * DAT 

HCLF . FFF 

HCL..FB . MAT 

1-ICL.FX . MAT 

POLDX * MAT 

P0LDX1 ♦ MAT 

P0LDX2 . MAT 

TR I CHI... ♦ BBB 

TRICHL.FFF 

•r err m , m f: f: 


MET CYC , DAT 
CYC HEX, BIN 
CYCHEX , DAT 

LJBZM , FOE 
ALA.CIN 
ALA, DAT 
VO AD AT , NH3 
TEMP, FOR 
CNDDAT , NH3 
X X X X X X « I" 0 K 

V (!) A , F 0 R 
CNDO ♦ FOR 
EQNL.CN , NH3 
V3NL.CN , NH3 
V3L0CN, NI-13 

V 4 M L G N , N H 3 
V4LOCN , NI-13 
V5NLCN, NI-13 
V5LQCN , NI-13 
V1NLCN, NI-13 
V1L.OCN, NI-13 
V2NL.CN , NI-13 

V 2 LG CM , MI-13 
V6NL.CN , MI-13 
V6L.OCN , NI-13 
VO A DAT , NDT 
CNDDAT , NDT 
V1NL.CN , NDT 
V1LOCN , NDT 
V2ML.CN , NDT 
V2I...0CN , NDT 
CM DO , DAT 
ECU IB, DAT 
V3NL.CN , NDT 
V3L0CN , NDT 


, Q I.J E B M A T , F 0 R / N A M E i " T 0 W M 8 E M D " 

|- 1 p j t b M A T :::: / 8 e « ? 1 2 5 1 / 1... i m i t 1 6 4 .1. I- i 1 e -I 

, Q t.J E C A R T , F 0 R / N A M E i " T 0 W N 8 E N D " 

I;; |... F' T t C A R T / 8 e <s i 1 2 5 2 / 1... :i. m :i. t t 7 3 1 I" i 1 e ..I 

, Q LJ E T E M P , I- 0 R / N A M E i " T 0 W M 8 E N D " 

[; | p f ; T E M I-' :::: / 8 e a i 1 2 5 3 / 1... :i. m i t i 5 1 1 I" 1 B 

, (a U E V 0 A , F 0 R / N A M E i 11 T 0 W N 8 E M D " 

[■ | p f $ u o A :::: / 8 e a i 1 2 3 4 / 1... :i. m :i. 1 1 9 7 v 1 F :i. 1 e ..I 


, K/F 

Job 34 User PRA8AD PL L4b4»l.U 
Lo**ed-Qtt TTYA at 16S32J23 on 1 7- Jun-8° 
Runtime? OtOOJOO, KCSJ 8 v Connect time, 0,03,0.1. 
Disk Reads i 119 9 Writes? 3 p Blocks saved, ObJ 


C h 3 r d e i $ 0 , 1 3 :::: $ 0 , 0 5 < R > + ^ * 0 , 0 1 < K > + * 0 * 0 7 ( L ' 

Y e a r - T o - D a t e A c c o u i"i t U s a d e ;■ 8 0 % 

089) SU TIMESHARING 16,32,55 TUE 06/17/80 VI M3 IX 


*P ~ l t 
00 : 1.00 
00200 
00300 
00400 
00500 
00600 
00700 
00800 
00900 
0 . 1.000 
0 . 1. 100 
*EB 


0 P E N ( U N I T = 3 o ? F I i... E = 
f.) P E N ( U N I T ■■■■ 3 .1. y F 1 1... E -~ 
DO 20 J " :; .1. y ;|. 20 

READ ( 30 y 2 ) X y Y y 2 y W y i 

WRITE <31 y2)X'y YyZ*W 
2 FORMAT ( 6 FI 2 « 6 ) 

20 CONTINUE 

0 L 0 S E ( U N I T 3 0 y F I L E •• 
0 L 0 S E ( IJ N I T =“ 3 .1. y F T I F ~ 
STOP 
END 


" CNDDAT * MCM ' ) 
•' GIANT ♦ FIT...' ) 

.1 y 0 
» IJ y 0 


' CNDDAT , MCH ' ) 
' GIANT «. FII... •' ) 


C DSKB t READ « FOR "I 


00100 

00200 

00300 

00400 

00500 

00600 

00700 

00800 

00900 

01000 

01100 

01200 

01300 

01400 

01500 

01600 

*ES 


10 

2 

1 

20 


0PEN<UNlT=30yFILE 
0PEN(UNIT=31 »FILE 
DO 20 J=1 » 13 
READ <30* 1 ) TITLE 
DO 10 1=1 r 23 
READ (30»2)X»YrZ 

WRITE<31*2>X»Y»Z 
READ < 30 r 1 ) TITLE 


SS ' 
— / 


CONTINUE i 
FORMAT <9Xr3F12»6) 
FORMAT (A4) 

CONTINUE 

CLOSE (UNIT=30» FILE 1 
CLOSE ( UNIT=31 yFILE 


STOP 

END 


GIANT »FIL' > 
GIAN*FIL' ) 


='GIANT*FIL' > 
s'GIANyFIL/ > 


